现象:首页正常,图片和 CSS 全挂
搬迁一个站点,程序放在 /var/www/app/public,静态资源在 public/static。Nginx 配好后首页能开,图片、CSS、JS 全部 404。error.log 里写着 open() ".../public/static/static/css/app.css" failed,路径里出现了两个 static。
原因:root 拼 URI,alias 换前缀
两种写法的拼接逻辑完全不同,混用就会多一层或少一层目录:
root把完整 URI 原样拼在指定目录后:请求/static/css/app.css,配root /var/www/app/public,结果是public/static/css/app.css,正确;alias把 location 匹配到的前缀替换成指定路径:location /static/配alias /data/assets/static/,前缀被换掉,也正确;- 错误写法是在
location /static/里写root .../public/static,URI 再拼一次就成了双 static;alias 漏写结尾斜杠则会拼出publicstatic这种不存在的路径。
解决步骤
第一步,优先统一用 root,只要磁盘结构和 URL 结构一致,root 最不容易错。注意 root 只写到 public 这一层:
location /static/ {
root /var/www/app/public;
expires 7d;
access_log off;
}
第二步,必须映射到别的目录时改用 alias,location 与 alias 的结尾斜杠要同时有或同时没有:
location /static/ {
alias /data/assets/static/;
}
第三步,正则 location 用 alias 必须带捕获组,因为正则没有可直接替换的前缀,还容易抢匹配,静态目录尽量别用:
location ~ ^/static/(.*)$ {
alias /data/assets/static/$1;
}
第四步,改完先校验再重载,然后用 curl 看状态码和 Content-Type:
nginx -t && nginx -s reload
curl -I https://example.com/static/css/app.css
仍然 404 就盯 error.log 里 open() 后面的绝对路径,和磁盘上 ls 的结果对照,多一层少一层一目了然。配置看着没错却仍然 404,用 nginx -T 打印合并后的配置;静态目录是软链接时,再查运行用户对目标目录的执行权限。
小结
root 是拼 URI,alias 是换前缀;root 不跟着 location 往下写,alias 的斜杠要和 location 对齐,正则里用 alias 必须带 $1。
