如何配置open_file_cache_valid指定日志句柄状态检索周期-Nginx-PHP中文网

open_file_cache_valid 仅控制 open_file_cache 中静态文件元信息（如存在性、inode）的校验周期，每30秒执行一次轻量级 stat() 检查，与日志句柄状态无关；日志文件句柄由 kill -usr1 信号或 open_log_file_cache 管理。

如何配置open_file_cache_valid指定日志句柄状态检索周期

open_file_cache_valid 是 Nginx 中用于控制 open_file_cache 缓存项有效性检查频率的指令，但它并不直接检索“日志句柄状态”——这是一个常见误解。该指令只影响被缓存的文件元信息（如是否存在、是否可读、inode 是否变化）的校验周期，与日志文件句柄（如 access_log 或 error_log 所用的文件描述符）完全无关。

Nginx 的日志文件句柄由 error_log 和 access_log 指令管理，其打开/刷新/重载行为由以下机制决定：

日志文件在 worker 进程启动时打开；
kill -USR1 信号触发日志轮转（即关闭旧句柄、打开新文件）；
open_log_file_cache（注意：不是 open_file_cache）才专门用于缓存日志文件句柄，且仅在启用时生效。

open_file_cache_valid 的真实作用

该指令定义 Nginx 多久检查一次 open_file_cache 中缓存的文件状态（例如：文件是否已被删除、权限是否变更、内容是否被外部修改）。它不扫描磁盘，而是对缓存中已记录的文件路径做轻量级 stat() 系统调用。

open_file_cache          max=1000 inactive=60s;
open_file_cache_valid    30s;   # 每30秒检查一次缓存项是否仍有效
open_file_cache_min_uses 2;

open_file_cache_valid 30s 表示：每 30 秒，Nginx 会遍历缓存中“最近未访问”的条目，重新 stat() 对应路径；
若 stat() 失败（如文件被删）或 inode/mtime 变化，该缓存项将被标记为过期，下次访问时重新打开；
它不主动刷新日志句柄，也不干预 access_log 的写入行为。

如需管理日志文件句柄状态，请用这些方式

Nginx 默认不缓存日志文件句柄；但可通过 open_log_file_cache 显式启用并控制：

open_log_file_cache max=1000 inactive=1m min_uses=2 valid=1m;

valid=1m：每 1 分钟检查一次缓存的日志文件句柄对应路径是否仍存在且可写；
inactive=1m：若某日志路径 1 分钟内无新写入，可能被从缓存中移除（下次写入再打开）；
min_uses=2：同一日志路径至少被 2 个请求使用过，才考虑加入缓存；
需配合 access_log /path/to/log.log main buffer=64k flush=5s; 使用更高效。

⚠️ 注意：open_log_file_cache 默认关闭，且仅对 access_log 生效（error_log 不受其影响）。

常见误操作与建议

❌ 把 open_file_cache_valid 设得很小（如 1s）来“实时感知日志轮转”——无效，且徒增系统负载；
✅ 日志轮转应始终用 kill -USR1 $(cat /var/run/nginx.pid) 或 nginx -s reopen，这是唯一可靠方式；
✅ 若应用自行 mv 或 cp 日志文件而未发信号，Nginx 仍向原句柄写入（Linux 允许），不会自动切换；
✅ 调试日志句柄状态可用：
```
lsof -p $(cat /var/run/nginx.pid) | grep log
```
查看 worker 进程实际打开的日志文件路径和 fd。