排查Nginx日志轮转失败需先确认logrotate是否执行、重载是否成功及权限路径是否正确;重点检查postrotate中nginx绝对路径调用、进程状态、SELinux限制,并通过debug模式和强制运行验证。

排查 Nginx 日志因 logrotate 报错而停止切分,核心是确认 logrotate 是否真正执行、是否成功重载 Nginx、以及权限和路径配置是否正确。常见问题不是 logrotate 没运行,而是它运行了但 reload 失败,导致旧日志继续写入、新日志未生成。
检查 logrotate 是否实际触发
logrotate 默认由 cron 每天执行一次(通常在 /etc/cron.daily/logrotate),但不会自动输出日志。需手动验证是否运行:
- 查看系统日志:运行 grep logrotate /var/log/syslog(Ubuntu/Debian)或 grep logrotate /var/log/messages(CentOS/RHEL),确认最近是否有执行记录及错误提示
- 强制运行并观察输出:执行 logrotate -d /etc/logrotate.d/nginx(-d 表示 debug 模式),它会模拟执行并打印每一步动作,包括匹配的文件、是否需要轮转、执行的 postrotate 脚本等 —— 这是最直接的诊断方式
- 检查时间戳:对比 /var/log/nginx/access.log 和 /var/log/nginx/access.log.1 的修改时间,若 .1 文件几天没更新,说明轮转已停滞
重点排查 postrotate 中的 nginx 重载失败
logrotate 切分后需通知 Nginx 关闭旧文件句柄、打开新日志,通常靠 kill -USR1 或 nginx -s reopen。失败时 Nginx 仍在往旧文件(如 access.log.1)写入,看似“没切分”,实为“切分了但没切换写入目标”:
- 检查配置中 postrotate 段是否使用绝对路径调用 nginx:例如写成 /usr/sbin/nginx -s reopen,而非仅 nginx -s reopen(cron 环境 PATH 可能不包含 /usr/sbin)
- 确认 nginx 主进程存在且有权限:执行 ps aux | grep "nginx: master",再尝试手动运行 postrotate 命令,看是否报 “nginx: [alert] could not open error log file” 或 “Permission denied”
- 注意 SELinux(RHEL/CentOS):若启用,setsebool -P logrotate_read_nginx_log on 可能必要;用 ausearch -m avc -ts recent 查看拒绝日志
核对 logrotate 配置的关键细节
常见配置错误会静默跳过轮转:
- 日志路径不匹配:确保 /etc/logrotate.d/nginx 中指定的路径(如 /var/log/nginx/*.log)与实际文件完全一致,支持通配符但不递归子目录
- size 和 daily 冲突:若同时配置 daily 和 size 100M,logrotate 默认只按时间判断(daily 优先),需改用 size 100M 单独控制,或加 ifempty 避免空文件干扰
- missingok 缺失:当日志文件首次部署尚未生成时,logrotate 会因找不到文件而报错退出(除非配置 missingok)
- create 权限错误:如写成 create 644 www-data www-data,但实际运行 logrotate 的用户是 root,而 Nginx worker 进程以 www-data 用户写日志 —— 此时新日志文件属主应为 www-data,否则 worker 无法写入
验证与临时修复步骤
快速定位并恢复服务:
- 手动执行轮转:logrotate -f /etc/logrotate.d/nginx(-f 强制),观察终端输出,尤其关注 “running postrotate script” 后是否有报错
- 检查新日志是否可写:sudo -u www-data touch /var/log/nginx/access.log,确认权限无阻塞
- 观察 Nginx 进程打开的文件:lsof -p $(cat /var/run/nginx.pid) | grep log,正常应显示 access.log(新文件),若仍显示 access.log.1,说明 reopen 失败
- 临时绕过脚本问题:把 postrotate 内容简化为 nginx -s reopen || true,先确保基本功能恢复,再逐步增强健壮性











