Nginx中alias因路径拼写错误致404，核心是大小写、斜杠位置与location匹配结果严格字符串替换；需确保URL、location和alias三者大小写完全一致，斜杠配对正确，并手动模拟替换逻辑验证最终路径是否存在且权限正确。
排查 alias 指令因路径拼写错误导致 404，关键不是“找错文件”，而是“算错路径”——Nginx 会严格按大小写、斜杠位置和 location 匹配结果做字符串替换，任何一处不一致都会让最终路径指向不存在的位置。
检查 URL、location 和 alias 三者大小写是否完全一致
Linux 文件系统区分大小写，/Static/ 和 /static/ 是两个不同路径。Nginx 不会自动转换或容错：
- 浏览器请求的 URL 路径（如 /assets/Css/main.css）必须与 location 块中定义的匹配模式（如 location /assets/Css/）逐字符一致
- alias 后的路径（如 /var/www/frontend/CSS/）也必须与磁盘实际目录名大小写完全吻合
- 常见陷阱：前端构建产物目录名是
css，但配置写了Css或CSS；URL 中用了大写/Img/，而磁盘只有小写/img/
验证 alias 路径末尾斜杠与 location 斜杠是否配对
斜杠不是格式问题，而是路径计算开关。配错就会发生“粘连”或“双斜杠”：
- 若 location 以 / 结尾（如
location /media/ { ... }），alias 值必须以 / 结尾（alias /mnt/nas/media/;） - 若 location 不带尾斜杠（如
location /api-docs），alias 值不能带尾斜杠（alias /srv/docs/v3） - 反例：location /media/ + alias /mnt/nas/media → 请求 /media/logo.png 会解析为
/mnt/nas/mediaproduct/logo.png（media和logo.png被粘连）
手动模拟 Nginx 的路径替换逻辑
别依赖猜测，用笔或命令行一步步还原 Nginx 的计算过程：
- 写出完整请求 URL（如
https://example.com/static/js/app.min.js） - 找出匹配的 location（如
location /static/ { alias /var/www/assets/; }） - 去掉匹配前缀（
/static/被砍掉，剩下js/app.min.js） - 将 alias 值直接接在后面（
/var/www/assets/+js/app.min.js=/var/www/assets/js/app.min.js） - 用
ls -l /var/www/assets/js/app.min.js确认该路径是否存在、权限是否正确
确认文件系统真实路径是否存在且可读
即使拼写全对，也可能因路径不存在或权限不足报 404（而非 403）：
- 执行
ls -l "$(dirname /var/www/assets/js/app.min.js)"查看父目录是否存在、是否可进入（需 x 权限） - 运行
stat /var/www/assets/js/app.min.js确认文件存在且 Nginx 用户（如 nginx 或 www-data）有读权限（r） - 若使用 SELinux，补充检查上下文：
ls -Z /var/www/assets/，必要时修复：chcon -Rt httpd_sys_content_t /var/www/assets
