Golang在Debian上日志记录有哪些常见误区

常见误区与规避建议

一 路径与权限配置

• 将日志目录或文件路径写死为相对路径，导致服务在不同工作目录下找不到或写入错误位置；应使用绝对路径，并通过 os.PathSeparator 保证跨平台分隔符正确。
• 未提前创建日志目录或权限不足，运行时直接失败或静默丢弃日志；应在初始化阶段使用 os.MkdirAll(path, 0755) 创建目录，并确保运行用户对目录具备写权限。
• 多协程并发写同一个 os.File 而未加同步，出现内容交错或数据竞争；应为每个输出目标加锁（如 sync.Mutex）或使用并发安全的日志库/多路写入核心。
• 将日志输出到仅 root 可写的系统目录（如 /var/log/）而未以合适用户运行；在 systemd 服务中显式设置 User/Group，或将日志落到应用可写目录并在 logrotate 中管理。

二 日志库与级别使用

• 长期使用标准库 log 的默认配置，缺少时间戳、文件名等关键信息；应在初始化时设置 log.SetFlags(log.LstdFlags | log.Lshortfile)，或切换到功能更完善的库。
• 只有“打印”，没有“级别”；在复杂业务中难以控制输出噪声与成本；应引入 DEBUG/INFO/WARN/ERROR 等级，并在生产环境默认使用 INFO 及以上。
• 依赖库版本不一致或未执行 go mod tidy，导致构建产物与本地调试行为不一致；应在构建前统一依赖并校验。
• 高并发下仍用同步日志，形成性能瓶颈；应使用高性能结构化日志库（如 zap、zerolog）或启用异步/批量写入能力。

三 轮转归档与系统服务集成

• 自己实现“按大小切割”且未处理文件句柄、锁竞争与并发安全，容易出现写入失败或丢失；推荐使用 lumberjack 等成熟方案，或交由系统工具管理。
• 依赖应用内轮转但未处理信号、进程崩溃等异常场景，导致历史日志未落盘；应使用 logrotate 统一管理轮转、压缩与保留策略。
• 将应用注册为 systemd 服务但未设置 StandardOutput/StandardError 或日志路径权限，导致 journald 与文件双写不一致或权限错误；应在 unit 中正确声明输出，并确保日志目录权限与属主匹配。

四 性能与结构化实践

• 大量打点使用字符串拼接，既慢又不利于检索；应使用结构化日志（如 zap、logrus），以字段方式输出 request_id、user_id、ip 等上下文。
• 错误只打消息不附堆栈与关键输入，排障困难；应在错误路径记录错误本身、必要的堆栈/参数快照，并按严重性分级。
• 日志洪泛未做采样与限流，既占磁盘又拖慢检索；应配置采样策略与合理的日志级别切换机制。
• 日志中包含敏感信息（密码、令牌、卡号等）；应在输出前进行脱敏或移除。

五 快速排查清单

• 核对日志目录是否存在且权限正确（如 0755），运行用户是否匹配；必要时在初始化用 os.MkdirAll 创建并设置属主。
• 检查初始化代码：是否设置了 log.SetFlags，是否以 O_CREATE|O_WRONLY|O_APPEND 打开文件，错误是否及时捕获与上报。
• 确认依赖一致：执行 go mod tidy，避免开发与运行环境不一致。
• 高并发路径是否加锁或使用并发安全日志器，避免内容交错与数据竞争。
• 生产是否启用级别控制与采样，避免 DEBUG 日志泛滥。
• 是否采用 logrotate 或 lumberjack 做轮转与压缩，保留策略是否合理。
• 作为 systemd 服务运行时，核对 User/Group、WorkingDirectory、StandardOutput/StandardError 与目录权限是否一致。