Nginx Alias 路径映射中避免 404 如何配

Nginx中alias映射不报404的关键在于严格匹配location与alias的结尾斜杠、遵循“替换而非追加”的路径计算逻辑、确保真实文件路径可被Nginx进程读取；错误常源于斜杠缺失导致路径粘连、混用root/try_files $uri忽略alias上下文、大小写或SELinux权限不一致。

配对 alias 路径映射不报 404，关键不是路径写对了就行，而是得让 Nginx 真正“算对”文件在哪。核心就三点：location 和 alias 的斜杠必须严格匹配、拼接逻辑要符合替换规则、真实文件路径得能被读到。

location 和 alias 都要带结尾斜杠

这是最常踩的坑。alias 不是追加，是替换 —— 它会把 location 匹配到的部分整个去掉，再把剩下的 URI 拼到 alias 路径后面。

1. 正确写法：location /static/ { alias /var/www/assets/; } → 请求 /static/css/main.css 对应磁盘路径 /var/www/assets/css/main.css
2. 错误写法：location /static/ { alias /var/www/assets; } → 同样请求会去找 /var/www/assetss/css/main.css（自动粘连，缺斜杠）
3. 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。

1. 安全写法：try_files $request_filename =404; —— $request_filename 是 Nginx 内部已根据 alias 计算出的绝对路径，直接检查是否存在
2. 避免混用：root 和 alias 不要在同一个 location 里共存，逻辑冲突容易翻车
3. 典型结构示例：

   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 更高效。

1. 临时加一行：return 200 "file: $request_filename";，curl 一下就能看到它到底打算读哪个文件
2. 检查文件权限：ls -l /var/www/assets/css/main.css，确保 nginx worker 用户（如 www-data）有读权限
3. SELinux 拦截常见：ls -Z /var/www/assets/，若上下文不对，执行 chcon -Rt httpd_sys_content_t /var/www/assets
4. 用 nginx -T 输出最终生效配置，确认你改的是正在运行的那个 server 块

特殊字符和大小写要同步一致

Linux 文件系统区分大小写，URL 编码也得规范。Nginx 自动解码请求 URI，但前提是客户端发来的就是标准编码。

1. 路径含中文或空格？alias 值写成：alias "/var/www/我的资源/";（引号包裹，不转义）
2. 浏览器请求必须是 URL 编码形式，比如 /静态/图片.png → 实际发 /%E9%9D%99%E6%80%81/%E5%9B%BE%E7%89%87.png
3. 检查三处大小写：浏览器地址栏、location 定义、alias 指向的磁盘目录名，全部保持一致