如何配置 open_file_cache_errors 缓存不存在状态减少无效磁盘查询-Nginx-PHP中文网

open_file_cache_errors 用于缓存“文件不存在”等错误结果，使后续相同请求直接返回404/403，跳过磁盘查询；必须配合 open_file_cache 及其相关指令（如 max、inactive、valid、min_uses）共同生效，单独启用无效。

如何配置 open_file_cache_errors 缓存不存在状态减少无效磁盘查询

open_file_cache_errors 的作用不是“记录”错误，而是把“文件不存在”“权限拒绝”这类失败结果缓存起来，让后续相同请求直接返回 404 或 403，跳过真实的磁盘查询和系统调用。

单独写 open_file_cache_errors on; 没有效果。它只是 open_file_cache 机制的一部分，依赖以下基础配置共同存在：

open_file_cache max=1000 inactive=60s; —— 提供缓存容器和淘汰规则
open_file_cache_valid 30s; —— 控制错误结果的缓存有效期（比如 404 缓存 30 秒后重新检查）
open_file_cache_min_uses 2; —— 对错误路径也适用：同一 404 路径需在 inactive 周期内重复出现至少 2 次才进入缓存

放在 http 或 server 块中即可：

open_file_cache max=2000 inactive=30s;
open_file_cache_valid 30s;
open_file_cache_min_uses 2;
open_file_cache_errors on;

说明：

高频探测的健康检查路径（如 /healthz）或固定不存在的旧资源路径（如 /old-api.js），会快速满足 min_uses=2 条件，被缓存为 404
valid=30s 意味着即使文件后来被创建，最多等待 30 秒就能命中新状态，兼顾性能与一致性
不建议设 valid 过长（如 >120s），否则可能长期返回过期的 404，影响上线调试

它不会写日志，但可通过系统行为观察：

用 perf stat -e syscalls:sys_enter_openat,syscalls:sys_enter_statx -p $(pgrep nginx) 压测同一 404 路径，开启前后对比系统调用次数应明显下降
用 lsof -p $(pgrep nginx) | grep "No such file" 查不到结果是正常现象——说明 Nginx 已跳过真实打开，直接返回缓存错误
临时关闭 open_file_cache_errors 并开启 error_log /path/to/log debug;，可看到大量 open() "/xxx" failed (2: No such file or directory) 日志；开启后这类日志会大幅减少