Nginx静态文件404:root和alias路径怎样对应

适用范围:Nginx提供本地静态文件;不适用于应用框架内部路由或对象存储URL。

磁盘上有文件,并不代表当前请求会去那个目录查找。先把请求URI代入实际命中的配置,算出Nginx要读取的文件,再检查文件和权限。

写出期望路径

假设访问 /assets/logo.png,真实文件在 /srv/site/assets/logo.png。使用root时,URI会接在root目录后面:

location /assets/ {
    root /srv/site;
}

这会对应 /srv/site/assets/logo.png。若误写 root /srv/site/assets;,路径就可能多出一层assets。[1]

如果实际文件在 /srv/static/logo.png,可以用alias替换已匹配的location前缀:

location /assets/ {
    alias /srv/static/;
}

这是两个不同的示例,二选一并替换成真实路径。不要把root和alias当成随时可互换的同义词。

检查实际命中的location

使用与运行进程一致的Nginx程序及配置路径,核对域名对应的server以及静态路径对应的location。nginx -T检查的是当前磁盘配置,运行实例是否已加载修改还要结合成功重载记录与实际请求验证。精确匹配、前缀匹配和正则匹配可能把请求送到不同规则中,不能只检查你刚编辑的那一段。[3]

sudo nginx -T
ls -l -- /srv/static/logo.png
namei -l /srv/static/logo.png

namei 可帮助查看路径中各级目录;没有安装时,逐级检查。目录“可列出”与进程能够穿过目录读取目标文件不是同一件事。不要用全站777修复。

斜杠和回退规则分别处理

目录映射的例子中,location与alias都用结尾斜杠。/assets 和 /assets/ 是不同请求,需要统一时应单独设计跳转,不要留下意外的路径拼接。正则location中的alias另有捕获组要求,不要直接套本例。[1]

静态资源缺失应返回真实404;不要把它一律回退到前端首页。否则浏览器拿到HTML后,常表现为MIME错误或脚本解析失败,而不是清楚的文件不存在。

以一个存在文件和一个不存在文件复测

先备份涉及的站点配置,检查语法后重载对应实例。请求已知存在的小文件,确认状态、类型和内容;再请求一个不存在的文件,确认得到404而不是首页或目录列表。检查错误日志中的实际路径,确认没有暴露不该公开的上级目录。

如果问题跟随文件名大小写变化,继续核对真实文件名与构建产物;不要同时改路由、权限和文件结构,否则很难确认修复点。

继续排查

Nginx配置多个域名与独立网站;Nginx网站403:目录、权限与访问规则排查;JS和CSS加载失败:MIME类型怎么查。

技术依据:[1] Nginx core模块:root、alias、location;[2] Nginx请求处理过程;[3] Nginx命令行参数。适用版本见本文说明。