Nginx 中利用 log_not_found 关闭资源缺失的错误记录-Nginx-PHP中文网

log_not_found指令用于控制nginx是否将文件未找到（404）错误记录到error_log，默认开启；关闭后可减少日志污染，但不影响响应状态码和access_log。

nginx 中利用 log_not_found 关闭资源缺失的错误记录

在 Nginx 中，log_not_found 指令用于控制是否将“文件未找到”（如 404）这类错误记录到 error_log。默认开启，意味着每次请求一个不存在的静态资源（比如缺失的 favicon.ico、robots.txt、图片或 JS 文件），Nginx 都会记一条 open() "/path/xxx" failed (2: No such file or directory) 日志。这类日志量大且多数无实际排查价值，尤其在前端单页应用（SPA）或存在大量试探性请求的场景下，容易污染错误日志，掩盖真正需要关注的问题。

log_not_found 的作用范围

该指令仅影响由 Nginx 自身文件系统查找失败触发的日志（主要是 location 块中使用 try_files、alias 或直接基于 root 查找静态文件时），不作用于代理（proxy_pass）、FastCGI 或其他后端返回的 404。它只控制 error_log 中的“文件未找到”级别日志（级别为 crit 或 error），不影响 access_log。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

启用时（默认）：缺失 favicon.ico 会记录一条 error 日志
关闭后：error_log 不再出现该类提示，但响应状态码仍是 404，access_log 照常记录

如何关闭资源缺失日志

在对应 server 或 location 块中添加 log_not_found off; 即可。推荐放在处理静态资源的 location 中，避免影响其他可能依赖该日志的模块（如调试文件路径问题时）。

全局关闭（不推荐）：http { log_not_found off; }
针对静态资源位置关闭（推荐）：

location / {
  root /var/www/html;
  log_not_found off;
  try_files $uri $uri/ /index.html;
}

配合 try_files 使用更合理

单页应用常用 try_files $uri $uri/ /index.html; 处理前端路由。此时浏览器可能请求 /api/user 以外的路径（如 /missing.css），Nginx 查找失败后本应返回 404，但因 try_files 回退到 /index.html，实际返回 200。这种情况下，log_not_found off 能避免记录大量“假缺失”日志——因为文件确实不存在，但业务上本就不该存在。