open_log_file_cache是Nginx用于缓存日志文件描述符以减少频繁open/close开销的机制，适用于日志路径含变量、多虚拟主机或频繁logrotate场景，需合理配置max、inactive、min_uses和valid参数。
open_log_file_cache 是 Nginx 提供的一个用于缓存日志文件描述符（file descriptors）的机制，主要目的是减少频繁打开/关闭日志文件带来的系统开销，尤其在高并发、日志轮转（log rotation）或大量虚拟主机共用相似日志路径的场景下效果明显。
缓存的作用和适用场景
默认情况下，Nginx 每次写入日志时都会调用 open() 和 write()（必要时还有 close()），尤其在使用 access_log /path/to/log main; 且路径含变量（如 $host、$server_name）时，每次请求都可能生成不同路径，导致频繁 open/close。启用缓存后，Nginx 会将已打开的日志文件 fd 缓存起来，复用而非反复打开。
典型适用情况包括：
- 日志路径中包含变量（如
access_log /var/log/nginx/$host-access.log;） - 大量 server 块各自定义了独立日志文件
- 使用 logrotate 频繁重命名/创建新日志文件，但旧 fd 仍被缓存占用
语法与常用参数
该指令位于 http、server 或 location 块中，基本语法为：
open_log_file_cache max=N [inactive=time] [min_uses=N] [valid=time] | off;
各参数含义：
- max=N：最大缓存条目数（即最多缓存多少个不同日志文件的 fd）
-
inactive=time：若某缓存项在指定时间内未被访问，则自动移出缓存（例如
inactive=10s） -
min_uses=N：在
inactive时间窗口内，该日志文件至少被写入 N 次才加入缓存（防偶然写入误缓存） - valid=time：每隔一段时间，Nginx 主动检查缓存中的文件是否仍存在且可写（避免因 logrotate 删除旧文件却仍往失效 fd 写入）
- off：显式禁用缓存（默认是关闭的）
示例配置：
http {
open_log_file_cache max=1000 inactive=20s min_uses=2 valid=1m;
# 其他配置...
}
关键注意事项
启用缓存不是“开箱即用就一定更好”，需结合实际权衡：
- 缓存本身消耗内存（每个条目约几十字节），
max过大会增加内存占用 -
valid检查依赖定时器，太短会增加 CPU 开销；太长可能导致写入已删除文件（errno: EBADF）——Nginx 会自动关闭失效 fd 并重新打开，但期间可能丢少量日志 - 如果日志路径不含变量（如固定路径
/var/log/nginx/access.log），Nginx 本身已内部复用 fd，此时开启缓存收益极小 - 配合 logrotate 使用时，建议在
rotate后发送USR1信号（nginx -s reload或kill -USR1 $(cat nginx.pid)），让 worker 进程重新打开日志，确保缓存与磁盘状态一致
如何验证是否生效
可通过以下方式简单确认：
- 查看 Nginx error log 中是否有类似
open() "/path/to/log" failed (2: No such file or directory)的报错（说明缓存中存在已失效路径） - 使用
lsof -p $(cat /var/run/nginx.pid) | grep log观察 worker 进程打开的日志文件数量是否稳定（开启缓存后不应随请求数线性增长） - 在含变量日志路径的配置下，对比开启/关闭缓存时的系统调用次数（用
strace -e trace=open,close,write -p $(pidof nginx)短暂采样）
不复杂但容易忽略——关键是按需启用、合理设参，而非盲目套用。
