nginx中alias映射不报404的关键在于严格匹配location与alias的结尾斜杠、遵循“替换而非追加”的路径计算逻辑、确保真实文件路径可被nginx进程读取；错误常源于斜杠缺失导致路径粘连、混用root/try_files $uri忽略alias上下文、大小写或selinux权限不一致。
配对 alias 路径映射不报 404，关键不是路径写对了就行，而是得让 Nginx 真正“算对”文件在哪。核心就三点：location 和 alias 的斜杠必须严格匹配、拼接逻辑要符合替换规则、真实文件路径得能被读到。
location 和 alias 都要带结尾斜杠
这是最常踩的坑。alias 不是追加，是替换 —— 它会把 location 匹配到的部分整个去掉，再把剩下的 URI 拼到 alias 路径后面。
- 正确写法：location /static/ { alias /var/www/assets/; } → 请求
/static/css/main.css对应磁盘路径/var/www/assets/css/main.css - 错误写法：location /static/ { alias /var/www/assets; } → 同样请求会去找
/var/www/assetss/css/main.css（自动粘连，缺斜杠） - location 末尾漏斜杠也危险：location /static { alias /var/www/assets/; } 可能只匹配到
/static，而/static/js/被截断或忽略
别在 alias 块里直接用 try_files $uri
try_files 默认按 root 解析，它不认识 alias 映射后的路径。$uri 还是原始 URL（比如 /static/js/app.js），Nginx 会去 root 目录下找这个完整路径，必然 404。
- 安全写法：try_files $request_filename =404; —— $request_filename 是 Nginx 内部已根据 alias 计算出的绝对路径，直接检查是否存在
- 避免混用：root 和 alias 不要在同一个 location 里共存，逻辑冲突容易翻车
- 典型结构示例：
location /assets/ { alias /opt/app/dist/assets/; try_files $request_filename =404; }
location / { root /opt/app/dist; try_files $uri $uri/ /index.html; }
验证路径是否真能访问到
别光看配置，得让 Nginx “说真话”。快速确认实际读取路径，比反复 reload 更高效。
- 临时加一行：return 200 "file: $request_filename";，curl 一下就能看到它到底打算读哪个文件
- 检查文件权限：
ls -l /var/www/assets/css/main.css，确保 nginx worker 用户（如 www-data）有读权限 - SELinux 拦截常见：
ls -Z /var/www/assets/，若上下文不对，执行chcon -Rt httpd_sys_content_t /var/www/assets - 用
nginx -T输出最终生效配置，确认你改的是正在运行的那个 server 块
特殊字符和大小写要同步一致
Linux 文件系统区分大小写，URL 编码也得规范。Nginx 自动解码请求 URI，但前提是客户端发来的就是标准编码。
- 路径含中文或空格？alias 值写成：alias "/var/www/我的资源/";（引号包裹，不转义）
- 浏览器请求必须是 URL 编码形式，比如
/静态/图片.png→ 实际发/%E9%9D%99%E6%80%81/%E5%9B%BE%E7%89%87.png - 检查三处大小写：浏览器地址栏、location 定义、alias 指向的磁盘目录名，全部保持一致
