首页 > 专题 > Go 结构化日志与 slog 工程实践专题

Go 结构化日志与 slog

Go 结构化日志与 slog 工程实践专题

从 log/slog、zap 与 zerolog 选型到 request_id、错误链和审计日志

结构化日志已经从第三方库能力变成 Go 服务的基础工程能力。这个专题以标准库 log/slog 为主线，结合 zap、zerolog 与站内真实案例，帮助你从日志格式、级别和字段规范一路落到错误追踪、请求关联和权限审计。

官方入口与标准库资料

从 Go 官方文档理解 slog 的 API、Handler 和工程边界

官方

Go 官方网站

Go 语言官方入口，汇总语言、工具链、标准库和最新发布信息。

官方

Go 博客：Structured Logging with slog

官方文章解释 log/slog 的设计动机、属性、Handler 和结构化输出。

官方

log/slog 官方 API 文档

标准库 log/slog 的完整 API、Handler、Level、Attr 和 LogValuer 参考。

官方

Effective Go

Go 官方工程实践指南，补充错误处理、接口和并发等日志上下文相关基础。

官方

Go 官方 slog 资源页

官方整理的 slog 生态、Handler 和扩展资源入口。

官方

Go 官方 slog 源码

Go 官方仓库中的 log/slog 实现、测试和源码入口。

站内相关文章

从日志库选型到错误追踪、级别治理和生产审计

文章

Go 结构化日志库怎么选：标准库 slog、zap 与 zerolog 的取舍

比较 slog、zap 与 zerolog 的依赖、扩展能力、迁移成本和基准测试方法。

文章

接口按钮隐藏了，为什么用户还能越权操作？后端权限校验这样补齐

展示权限校验中的放行与拒绝审计，并用请求追踪 ID 串起网关和业务日志。

文章

Golang错误日志技巧：结构化与错误追踪方法

介绍 JSON 日志、request_id、错误上下文和统一入口记录的组合方式。

文章

Golang错误日志优化方案详解

从错误上下文、堆栈、级别和报警策略出发优化 Go 错误日志。

文章

Golang日志分级与输出配置全解析

讲解日志级别、输出目标和 zapcore 多路输出配置。

文章

Go 错误链处理实战：用 errors.Is 和 errors.As 保留根因

通过 %w、errors.Is 和 errors.As 保留底层根因，并在 HTTP 层统一映射。

文章

Go worker pool 实战：用 channel 控制并发和收集结果

用固定 worker、任务队列和结果通道控制并发，覆盖批量任务和日志清洗场景。

文章

Golang日志轮转：lumberjack与自定义方案

介绍日志文件轮转的常用方案、容量控制和自定义实现思路。

生产落地检查清单

把字段规范、敏感信息和性能验证纳入发布前检查

问答

先固定字段语义，再替换日志库

统一 service、environment、request_id、trace_id、error 和业务主键命名；禁止把令牌、完整请求体和敏感个人信息直接写入日志。

问答

用真实输出链路做基准

固定日志样本、级别、字段、输出目标和采样规则，比较分配、吞吐、尾延迟、采集量与告警命中，而不是只看空日志微基准。

问答

统一错误记录边界

在最终处理边界记录完整错误链和堆栈，其他层只补充上下文并返回根因，避免同一个错误在多层重复打印。