404错误首要排查Nginx实际匹配的location及root/alias路径：用nginx -T | grep -A 5 "location /path"确认生效配置，区分root自动拼接与alias精确映射；再结合access.log还原物理路径，用ls验证文件存在性、大小写和权限；SPA需在根location加try_files $uri $uri/ /index.html兜底。
遇到 404，第一反应不是“文件没放对”，而是“Nginx 去哪找了”。location 匹配是 Nginx 找路径的起点，错一步，后面全偏。
确认生效的 location 和 root/alias
很多人改了配置却没生效，是因为没查到真正起作用的那一条。运行：
nginx -T | grep -A 5 "location /your-path"
看输出里实际匹配的是哪个 location 块，以及它内部用的是 root 还是 alias。特别注意：
- 如果 location 是
location /api/ { root /opt/app; }，访问/api/v1/user，Nginx 实际查找的是/opt/app/api/v1/user（自动拼上前缀） - 如果想让
/api/直接映射到/opt/app/，就得换用alias /opt/app/;（结尾斜杠不能少） - server 级的 root 会被 location 内的 root 覆盖，别默认它还有效
手动还原物理路径并验证存在性
从 access.log 拿到出错的请求，例如：
192.168.1.50 - - [01/Oct/2026:14:22:03 +0000] "GET /js/app.js HTTP/1.1" 404 153
按以下三步还原：
- 找到该请求命中 location 的 root 值（比如
root /var/www/site;） - 拼出完整路径：
/var/www/site/js/app.js - 执行
ls -l /var/www/site/js/app.js，检查：文件是否存在、大小写是否一致、权限是否允许 Nginx 用户读取（如www-data）
排查 SPA 刷新 404 和假 404
前端用 History 模式（如 Vue Router 或 React Router 的非 hash 模式）时，刷新子路由出现 404，本质不是路径错，而是 Nginx 没兜底：
- 必须加
try_files $uri $uri/ /index.html;在根 location 里 - 别把
try_files放在location /api/这类代理块里——它只对静态资源生效 - 检查是否被 CDN 缓存了旧路径（比如带大写或尾部斜杠），导致请求根本没到 Nginx
- 预检请求（OPTIONS）返回 404？那是 CORS 配置缺失，不是路径问题
看日志定位真实原因
access.log 告诉你“谁、什么时候、要什么、结果 404”；error.log 才告诉你“为什么找不到”：
-
open() "/var/www/site/css/main.css" failed (2: No such file or directory)→ 文件真不存在 -
directory index of "/var/www/site/" is forbidden→ 目录没配index，也没开autoindex -
Permission denied→ 权限或 SELinux 上下文不对（CentOS/RHEL 尤其要注意chcon -t httpd_sys_content_t）
