Nginx 日志平滑切割关键在于 logrotate 触发后通过 kill -USR1 通知 Nginx 主进程重开日志文件,而非重启服务;需确保 postrotate 正确执行、权限路径匹配,并手动验证新旧文件句柄切换。

关键在于 logrotate 切割后让 Nginx 主动关闭旧日志文件句柄、打开新文件,而不是简单重启服务。Nginx 本身不自动感知日志文件被重命名,必须通过信号通知它“重载日志缓冲区”,这个过程不中断请求,就是平滑切割的核心。
logrotate 配置里必须有 postrotate 段
logrotate 默认只改名、压缩、删旧日志,但 Nginx 进程仍持有原 access.log 或 error.log 的文件描述符,继续往旧文件写——这会导致磁盘空间不释放,也违背“切割”本意。所以必须在 postrotate 中发信号,触发 Nginx 重新打开日志文件。
- 推荐用 kill -USR1:这是 Nginx 官方支持的“重新打开日志文件”信号,worker 进程会各自关闭旧句柄、按配置中的
access_log路径新建并写入新文件,全程不中断连接 - 避免用
nginx -s reload:虽然也能生效,但它会 fork 新 worker、优雅关闭旧 worker,属于全服务重载,开销更大;而 USR1 只处理日志,更轻量、更精准 - 确保 pid 文件路径正确:如使用
/run/nginx.pid或/var/run/nginx.pid,命令要能读取到主进程 PID;若 Nginx 启动未指定 pid 路径,需先检查nginx.conf中的pid指令
日志路径和权限不能出错
平滑的前提是 Nginx 能顺利创建并写入新日志文件。如果权限不对或目录不存在,USR1 之后会报错(如 “open() ‘/var/log/nginx/access.log’ failed (13: Permission denied)”),导致日志丢失。
-
create 0644 nginx nginx要匹配实际运行用户:Debian/Ubuntu 常为www-data,CentOS/RHEL 多为nginx;属组也需一致(如adm或root) - 确保
/var/log/nginx/目录存在且可写:logrotate 以 root 身份运行,但新文件属主是 nginx 用户,该用户需对目录有写权限(通常 root 创建目录 + 设置 group-writable + sgid 即可) - 确认 Nginx 配置中
access_log和error_log使用的是绝对路径,且没有用变量或相对路径,否则 USR1 后可能写错位置
验证和调试要点
配置写完不是一劳永逸,得动手验证是否真“平滑”——既没丢日志,也没卡住写入。
- 手动触发测试:
sudo logrotate -vf /etc/logrotate.d/nginx,观察输出是否成功 rename、compress,并检查 postrotate 是否无报错 - 检查文件时间戳:切割后,
ls -lt /var/log/nginx/*.log*应看到新的access.log修改时间是当前时刻,而access.log.1是上一周期的末尾时间 - 实时观察写入:
tail -f /var/log/nginx/access.log,再发起几个请求,确认新日志有内容;同时lsof -p $(cat /run/nginx.pid) | grep log可验证进程是否已指向新文件 - 留意系统日志:
journalctl -u nginx -n 20或tail /var/log/nginx/error.log,看是否有 USR1 处理失败或 open 日志失败的提示
整个流程不复杂但容易忽略细节,重点就三件事:配对的 postrotate 信号、正确的文件权限与路径、以及一次认真的手动验证。











