404错误表明Nginx运行正常但无法映射URL：先用curl验证是否Nginx返回，再查error.log定位是文件缺失还是后端透传；检查root路径拼接逻辑、SPA需try_files fallback；反向代理注意proxy_pass斜杠、Host头设置；静态资源路径误用root时应改用alias。
当你在浏览器中输入网址后看到“404 Not Found nginx/1.23.4”这类提示，说明Nginx已正常运行并接收请求，但无法将该URL映射到服务器上真实存在的文件或后端服务——问题不在网络连通性，而在路径指向、权限控制或代理逻辑的某一处断开了。
确认404是Nginx返回还是后端透传
先用curl绕过浏览器，直连Nginx本机验证：curl -I http://localhost/your-path。如果返回HTTP/1.1 404，再查Nginx error.log：tail -n 20 /var/log/nginx/error.log。若日志里出现“open() "/var/www/html/xxx" failed (2: No such file or directory)”，说明是Nginx自己找不到文件；若日志显示“upstream sent no valid HTTP/1.0 response”，那404实际来自被代理的后端服务，Nginx只是原样转发了错误响应。
这一步必须做，否则可能花两小时调Nginx配置，而真正的问题在Java服务的Spring Boot路由没注册。
检查root路径与文件系统是否匹配
打开你的server块配置（通常在/etc/nginx/conf.d/your-site.conf），找到类似这样的段落：
location / {
root /var/www/myapp;
index index.html;
}
执行命令ls -l /var/www/myapp/index.html，确认该文件真实存在且有读权限。注意：root指令拼接路径的逻辑是“root值 + URI完整路径”，比如访问/example.css，Nginx会去读/var/www/myapp/example.css；但如果你把root错写成/var/www/myapp/static，它就会去找/var/www/myapp/static/example.css——而该路径下根本没这个文件。
【root路径末尾不加斜杠，且必须指向包含index.html的父目录】
修复单页应用（SPA）刷新404问题
Vue、React等前端项目启用history路由后，/user/profile这类地址没有对应物理文件，Nginx默认会返回404。必须让所有非静态资源请求 fallback 到index.html。
方法一：在location /块中添加try_files指令
location / {
root /var/www/frontend;
try_files $uri $uri/ /index.html;
}
方法二：更严格的写法（推荐用于生产环境）
location / {
root /var/www/frontend;
try_files $uri $uri/ @fallback;
}
location @fallback {
rewrite ^(.*)$ /index.html break;
}
改完后务必运行nginx -t测试语法，再systemctl reload nginx生效。别跳过-t检测，一个漏掉的分号会让整个server块失效。
排查反向代理中的路径错配
第一步：检查proxy_pass末尾斜杠
① location /api/ { proxy_pass http://127.0.0.1:8080/; } → 访问/api/user会转发到http://127.0.0.1:8080/user
② location /api/ { proxy_pass http://127.0.0.1:8080; } → 同样访问/api/user却转发到http://127.0.0.1:8080/api/user
第二步：强制设置Host头
proxy_set_header Host $proxy_host; 这行必须显式写出。Nginx默认传递客户端的Host（比如www.test.com），但后端服务可能只认自己的域名（api.prod.com）或依赖Host做租户识别，不设这行，后端直接拒收请求并返回404。
第三步：验证后端是否真能响应
curl -v http://127.0.0.1:8080/user/login —— 如果这里也404，问题100%不在Nginx，立刻转向后端日志排查。
修正静态资源前缀路径（alias误用场景）
当你配置类似location /images/ { root /mnt/data; }，Nginx会尝试读取/mnt/data/images/logo.png；但你实际想让它读/mnt/data/logo.png，就必须换用alias：
location /images/ {
alias /mnt/data/;
}
【alias值末尾必须带斜杠，且不能和root混用在同一location中】
alias的路径替换规则是“去掉location匹配前缀，再拼接alias值”，所以/mnt/data/ + logo.png = /mnt/data/logo.png，刚好符合预期。
