linux 中 nginx 平滑重载后静态资源出现 404，通常是因为重载过程中文件句柄未正确释放或缓存策略导致旧索引失效。排查时重点检查 nginx.conf 中的 root 路径是否变更、try_files 配置是否正确以及服务器时间同步情况。
如何验证 Nginx 配置文件语法并安全重载
验证配置文件语法是排查的第一步，使用 -t 参数可以确保配置无误。安全重载通过发送 SIGHUP 信号实现，该信号会让主进程重新加载配置并启动新的工作进程，而不会中断现有连接。
sudo nginx -t sudo kill -s HUP $(cat /var/run/nginx.pid)
执行上述命令后，观察 /var/log/nginx/error.log 是否有报错。如果配置语法正确但依然 404，说明问题不在配置解析阶段，而在运行时环境或文件系统层面。
为什么重载后静态资源会返回 404
平滑重载后出现 404，常见原因是工作进程持有的文件描述符（FD）与新进程访问的文件系统状态不一致。例如，如果静态资源目录在重载期间被移动或删除，旧的工作进程可能仍持有指向已删除文件的 FD，而新进程尝试访问时因路径不存在而返回 404。此外，如果使用了 open_file_cache，重载可能导致缓存条目失效，若此时文件确实不存在，则会直接返回 404。
# 检查当前运行的 Nginx 进程及其打开的文件 lsof -p $(pidof nginx) | grep static_resource_dir # 检查文件是否存在且权限正确 ls -l /path/to/static_resources # 检查 Nginx 错误日志 sudo tail -f /var/log/nginx/error.log
通过 lsof 命令可以查看 Nginx 进程是否仍然试图访问旧的或不存在的路径。同时，确认静态资源文件的权限是否为 Nginx 运行用户（通常是 www-data 或 nginx）可读。如果文件权限或所有者在重载前被修改，也可能导致 404。
基于 open_file_cache 配置的具体问题排查
当启用 open_file_cache 时，Nginx 会缓存文件元数据。如果重载发生在文件被删除或重命名之后，缓存中可能仍保留着旧文件的引用，导致新请求无法找到文件。此时，需要检查 open_file_cache_valid 和 open_file_cache_min_uses 的设置。如果缓存验证时间过长，可能会持续返回 404 直到缓存过期。解决方法是调整这些参数或暂时禁用缓存以验证问题根源。
