Nginx日志为何不全

Nginx 日志“不全”是一个比较常见的现象，通常不是 Nginx 本身丢了日志，而是配置、缓冲、权限或理解偏差导致的。下面按常见原因系统梳理一下。

一、最常见原因

1. 日志缓冲（buffer / flush 机制）

Nginx 默认对访问日志有缓冲，不是每条请求立刻写盘。

access_log /var/log/nginx/access.log main buffer=32k flush=5s;

• buffer=32k：攒够 32k 才写
• flush=5s：最多 5 秒写一次

后果：

• 服务刚重启 / 崩溃时，最近几秒日志可能丢失
• 低流量时，日志“迟迟不出现”

✅ 排查：

nginx -T | grep access_log

2. error_log 级别设置过高

error_log /var/log/nginx/error.log warn;

• warn 以上才会记录
• info、notice 不会写

常见“看不到日志”的情况：

• 请求被 return 403 但没报错
• rewrite 被忽略
• upstream 连接慢但不算 error

✅ 建议排查时临时改：

error_log /var/log/nginx/error.log debug;

3. 某些请求根本没进 Nginx 日志

以下情况不会写 access_log：

✅ 被 return 提前拦截

location /health {
    return 200;
}

（会记，但容易误以为没记）

❌ 被 error_page + 内部跳转

有时只记最终状态

❌ 被 deny 直接拒绝（部分版本不记）

deny 1.2.3.4;

❌ 连接未完成（挂起 / 超时）

• 客户端断开
• TLS 握手失败
• 超时未发完请求

4. 多个 server / location 写了不同日志

server {
    access_log /var/log/nginx/a.log;
}

server {
    access_log off;
}

或：

location /api {
    access_log off;
}

✅ 检查：

nginx -T | grep -E "access_log|error_log"

5. 日志被轮转（logrotate）截断

常见现象：

• 日志“突然没了”
• 文件存在但大小为 0
• 老日志在 .gz

✅ 检查：

ls -lh /var/log/nginx/

6. 权限问题（写不进去）

Nginx worker 用户写不了日志目录：

ps aux | grep nginx

常见：

• nginx 用户
• 日志目录属主是 root

✅ 修复：

chown -R nginx:nginx /var/log/nginx
chmod 755 /var/log/nginx

7. 使用了 syslog / 外部日志

access_log syslog:server=127.0.0.1:514;

此时：

• 本地文件无日志
• 日志在 rsyslog / journald

✅ 检查：

nginx -T | grep syslog
journalctl -u nginx

8. Docker / K8s 环境

• Nginx 日志在容器内
• 宿主机看不到
• 或 stdout 被采集

✅ 查看：

docker logs <container>
kubectl logs <pod>

二、快速自检清单 ✅

# 1. 看配置
nginx -T | grep -E "access_log|error_log"

# 2. 看文件
ls -lh /var/log/nginx/

# 3. 看进程用户
ps aux | grep nginx

# 4. 看实时日志
tail -f /var/log/nginx/access.log

# 5. 临时 debug
error_log /var/log/nginx/error.log debug;

三、如果你愿意，我可以更精确帮你

你可以贴：

1. nginx -T 中相关 log 配置
2. 操作系统（CentOS / Ubuntu / Docker）
3. “不全”具体表现（没记录 / 少记录 / 延迟）

我可以直接帮你定位是哪一类问题。