问题现象

日志文件未出现在配置的目标目录，而是生成在其他路径。

成因分析

• 路径配置时未使用跨平台分隔符；
• 多协程并发写入时路径处理不当；
• 环境变量未正确设置或读取；
• 日志目录权限不足。

解决方案

使用拼接路径，比方说logPath := ；使用保护日志写入操作；在程序启动时检查并设置环境变量；初始化时创建目录并设置权限。

/var/log/myapp/*.log {
    daily
    rotate 7
    missingok
    notifempty
    compress
    create 0644 www-data www-data
}

使用第三方日志库的日志轮转功能。

程序报错“missing entry”或“cannot find package”，导致日志功能无法正常使用。

依赖包未正确下载或文件未同步。

在项目目录下施行go mod tidy自动下载缺失的依赖包并整理和文件。

日志输出格式不符合需求，或日志级别设置过高。

未调用设置输出格式，或未调整日志级别。

• 使用设置输出格式；
• 使用第三方日志库支持日志级别。

import (
    "/zap"
    "/zap/zapcore"
)func main {
    config := {
        Encoding:         "json",
        Level:            ,
        OutputPaths:      string{"stdout", "/var/log/myapp/"},
        ErrorOutputPaths: string{"stderr"},
    }
    logger, _ := 
    defer 
    )
}

7. 日志文件管理问题

问题现象：日志文件持续增长， 占用大量磁盘空间，影响系统稳定性。

未配置日志轮转，旧日志未被清理。

使用logrotate工具配置日志轮转：

高并发时日志写入成为瓶颈，标准库log的性能不足。

标准库log是同步阻塞的，每条日志写入都会等待磁盘IO完成。

使用高性能第三方日志库， 其采用异步写入和零拷贝技术，显著提升性能。示例代码：

程序报错“permission denied”或日志文件无法写入。

日志目录或文件的权限设置过严，而程序以普通用户运行。

• 在程序初始化时递归创建目录并设置合理权限；
• 确保程序运行的用户对日志目录有写入权限。

程序无法找到日志目录，或依赖的GOROOT/GOPATH路径错误导致编译或运行异常。

未正确设置环境变量，或变量未生效。

• 编辑全局配置文件或用户配置文件， 添加export LOG_DIR=/var/log/myapp；
• 对于GOROOT/GOPATH，确保变量指向正确的Go安装路径和项目目录；
• 施行source /etc/profile或source ~/.bashrc使配置生效。

---