Nginx 配置 root 和 alias 写反了,静态文件一直 404

现象:首页正常,图片和 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。

您可以还会对下面的文章感兴趣: