答案是：collectstatic未执行或未生效导致STATIC_ROOT目录为空，Nginx配置中误用root而非alias是404主因。需在Docker启动时执行collectstatic --noinput，Nginx用alias映射/static/且末尾不加斜杠，确保路径三段对齐。
collectstatic 没跑或没生效
Docker 容器重启后，STATIC_ROOT 目录是空的——因为 collectstatic 只在执行时写入文件，不会自动重跑。很多镜像只在构建阶段跑一次，但如果你用的是 volume 挂载代码、又没做初始化处理，容器启动时静态文件根本不存在。
- 确保 Dockerfile 或启动脚本里明确执行了
python manage.py collectstatic --noinput（加--noinput避免交互阻塞） - 如果用
docker-compose.yml，别把STATIC_ROOT目录挂载成空 volume；要么挂载已有内容的 volume，要么在 entrypoint 中先运行 collectstatic 再启动服务 - 检查容器内
STATIC_ROOT路径是否真实存在且可写：进容器执行ls -l /path/to/staticfiles，确认目录权限不是 root-only（尤其在非 root 用户运行时）
Nginx 的 location 配置错用了 root 而不是 alias
这是最常被抄错的一处。Nginx 用 root 和 alias 处理 /static/ 请求时行为完全不同：
-
location /static/ { alias /app/staticfiles/; }→ 请求/static/css/main.css会映射到磁盘路径/app/staticfiles/css/main.css -
location /static/ { root /app/staticfiles/; }→ 同样请求会映射到/app/staticfiles/static/css/main.css（多了一层static）
Django 的 STATIC_URL = '/static/' 是带尾部斜杠的，Nginx 必须用 alias，且 alias 路径末尾不能加斜杠（否则 404）。
立即学习“Python免费学习笔记（深入）”；
- 在 docker-compose 中确保 Nginx 容器能访问 Django 的
STATIC_ROOT目录：通过 shared volume 或 network 共享路径 - 检查 Nginx error log：
tail -f /var/log/nginx/error.log，常见报错是open() "/app/staticfiles/static/..." failed (2: No such file or directory)，这就是root误用的典型信号
模板里 {% static %} 标签没生效或路径拼错
即使后端配置全对，前端也可能因模板问题加载失败：
- 模板顶部必须有
{% load static %}，且必须在所有{% static %}之前 - 路径是相对于
STATICFILES_DIRS或 app 下static/子目录的，不是相对于项目根目录。比如static/css/base.css要放在myapp/static/myapp/css/base.css或BASE_DIR / "static" / "css" / "base.css" - Linux 容器区分大小写：模板写
{% static 'Css/style.css' %}，但文件实际叫css/style.css，就会 404 - 开发时用
DEBUG=True可以临时绕过 collectstatic 直接读STATICFILES_DIRS，但这在生产环境无效，别依赖它验证最终效果
Django settings.py 静态配置漏项或路径类型不一致
STATIC_ROOT 必须是绝对路径，且和 Nginx 实际服务的路径严格一致；而 STATICFILES_DIRS 是开发时查找源文件的路径列表，两者不能混用。
- 用
pathlib.Path（推荐）或os.path.join构造路径，避免硬编码字符串拼接出错 -
INSTALLED_APPS中必须包含'django.contrib.staticfiles'，否则{% static %}标签根本不可用 -
STATIC_URL值必须以/开头、结尾不加/（如STATIC_URL = '/static/'），否则 Nginx location 匹配和模板生成 URL 都会出错 - 如果用了 WhiteNoise，注意它只在
DEBUG=False且没配 Nginx 时才接管静态服务；一旦上了 Nginx，WhiteNoise 就该关掉，否则反而干扰路由
静态文件问题本质是三段路径对齐：Django 模板生成的 URL → Nginx location 规则 → 容器内真实文件路径。少对齐一段，就 404。最容易被忽略的是 Nginx 的 alias 末尾多写斜杠，或者 collectstatic 后没检查 STATIC_ROOT 目录里到底有没有文件。
