根本原因是Nginx配置错误：location与alias路径不匹配、Docker卷未正确挂载或三者路径字面量不一致，导致Nginx无法定位collectstatic生成的静态文件。
根本原因不是Django没找到文件，而是Nginx根本没把请求转发到正确路径——location 和 alias 的组合写错了，或者Docker卷没对上。
为什么 collectstatic 后 Nginx 还是返回 404？
因为 Nginx 配置里 location /static/ 和 alias 路径不匹配，导致它去错目录找文件。常见错误有：
-
location /static/ { alias /app/staticfiles/; }—— 末尾斜杠不一致，Nginx 会把/static/css/main.css映射成/app/staticfiles//css/main.css（多一个/），直接 404 -
location /static { alias /app/staticfiles; }—— 正确写法：两者都不带尾部斜杠，Nginx 才能干净替换前缀 -
alias指向的路径在 Nginx 容器里根本不存在，比如 Docker Compose 没把staticfiles目录挂载进去 - Django 容器运行了
collectstatic，但输出目录是/app/staticfiles，而 Nginx 配置却写了alias /app/static/
为什么 Django 容器里 collectstatic 成功，但文件还是不生效？
因为 collectstatic 只负责“打包”，不负责“暴露”。它生成的文件必须被 Nginx 容器以只读方式访问到，这依赖 Docker 卷映射是否精确：
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- 确保
docker-compose.yml中两个服务共享同一卷：static_volume:，且都声明了volumes:挂载点 - Django 服务挂载时应写成：
- static_volume:/app/staticfiles（对应STATIC_ROOT） - Nginx 服务挂载时必须一模一样：
- static_volume:/app/staticfiles，否则就是两份独立目录 - 别用
./staticfiles:/app/staticfiles这种本地路径绑定——在 CI/CD 或远程服务器上会失效
为什么 DEBUG=False 时模板里 {% static %} 生成的 URL 是对的，但点开就是 404？
说明 Django 渲染没问题，问题纯属 Nginx 层未接管请求。关键检查点：
立即学习“Python免费学习笔记（深入）”；
- 确认 Nginx 配置中
location /static块在location /（反向代理到 Django）之前——顺序错会导致所有/static请求被 proxy_pass 拦截 - 执行
docker exec -it nginx-container ls -l /app/staticfiles/css/，看文件真实存在且权限为644（Nginx 用户可读） - 浏览器打开
http://yoursite.com/static/css/main.css，看响应头是否有X-Content-Type-Options: nosniff—— 如果有，说明已由 Nginx 处理；如果返回X-Frame-Options或Server: Django，说明请求根本没进 Nginx 的location块 - 不要在 Nginx 配置里混用
root和alias：对/static必须用alias，用root会导致路径拼接错误
最易被忽略的是：Nginx 容器内路径、Django 的 STATIC_ROOT、Docker 卷挂载目标三者必须字面量完全一致，一个字母都不能差——大小写、斜杠、相对/绝对路径，全算。
