Debian Golang日志为何报错

Debian 上 Golang 日志报错 的原因很多，不能一概而论。下面我按最常见场景给你一个排查清单，并给出典型错误示例 + 解决方法。你可以对照看看属于哪一种。

一、最常见原因速查表

二、最常见的 3 类实际问题

1️⃣ 权限问题（最常见）

报错示例

2026/01/15 10:00:00 open /var/log/myapp.log: permission denied

原因

• Debian 下 /var/log 默认 root 可写
• 普通用户或 systemd 服务无权限

解决

sudo mkdir -p /var/log/myapp
sudo chown -R $USER:$USER /var/log/myapp

或（推荐）：

sudo chown -R myapp:myapp /var/log/myapp

2️⃣ systemd 服务运行 Go 程序

报错示例

open /var/log/myapp.log: no such file or directory

原因

• systemd 启动 Go 程序
• 目录不存在
• 或被 ProtectSystem=full 限制

正确做法（推荐）

service 文件

[Service]
ExecStart=/usr/local/bin/myapp
LogsDirectory=myapp

systemd 会自动创建：

/var/log/myapp

3️⃣ Go 日志代码问题

错误示例

log.SetOutput(os.OpenFile("/var/log/app.log", os.O_CREATE|os.O_WRONLY, 0644))

❌ 忘记处理 error

✅ 正确写法

f, err := os.OpenFile("/var/log/app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
if err != nil {
    log.Fatal(err)
}
log.SetOutput(f)

三、常见日志库在 Debian 上的坑

zap

zap: cannot create sink "file:///var/log/app.log"

✅ 解决

sudo mkdir -p /var/log
sudo chown app:app /var/log

logrus

open /var/log/app.log: no such file or directory

✅ 解决

file, _ := os.OpenFile("/var/log/app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
log.SetOutput(file)

四、你可以直接这样排查（推荐）

# 1. 看完整错误
journalctl -u your-service -e

# 2. 看程序运行用户
ps aux | grep your-app

# 3. 看目录权限
ls -ld /var/log

# 4. 手动运行程序看是否报错
./your-app

五、如果你愿意，我可以精准定位

你可以直接贴出：

1. 完整报错信息
2. Go 日志相关代码
3. 是否在 systemd / Docker / 裸机 Debian
4. Debian 版本（如 11 / 12）

我可以直接帮你定位到具体哪一行代码或配置导致的问题。