Nginx匹配/assets路径却无视对应location块问题求助

核心问题分析 #

1. root指令使用错误：你在location /assets中使用root时，Nginx会将root指定的路径与请求URI直接拼接。比如请求/assets/admin/css/base.css时，实际查找路径会变成/home/user/project/backend/staticfiles/assets/admin/css/base.css——但Django收集静态文件后，admin等目录是直接放在staticfiles下的，多出来的assets层级导致文件找不到。
2. 尾斜杠请求的异常：给请求加尾斜杠后，Nginx会将其视为目录，尝试查找该路径下的index.html，但因root的路径拼接错误，依然无法定位到正确文件。

解决步骤 #

修改location /assets的配置，将root替换为alias，适配Django静态文件的目录结构：

location /assets {
    alias /home/user/project/backend/staticfiles;
    # 可选：添加缓存控制优化静态文件访问
    expires 30d;
    add_header Cache-Control "public, immutable";
}

• alias与root的区别：alias会将location匹配的URI部分替换为指定路径，请求/assets/xxx会直接映射到/home/user/project/backend/staticfiles/xxx，完全匹配Django静态文件的存储结构。
• 缓存优化：添加缓存头可减少重复请求，提升静态文件访问效率。

验证流程 #

1. 执行nginx -t确认配置语法无误。
2. 重启Nginx服务：systemctl restart nginx（根据系统服务管理命令调整）。
3. 重新请求website.com/assets/admin/css/base.css，验证文件是否正常返回。

内容的提问来源于stack exchange，提问作者KhoPhi