根本原因是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 卷映射是否精确：
Docker Image Puller
下载
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
- 确保
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 层未接管请求。关键检查点：
- 确认 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 卷挂载目标三者必须字面量完全一致，一个字母都不能差——大小写、斜杠、相对/绝对路径，全算。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
