static_root未配置或配错会导致collectstatic失效、静态文件404；它必须是真实可写的唯一空目录，不可与staticfiles_dirs重叠，且web服务器需严格指向该路径。
STATIC_ROOT 配置错误导致 collectstatic 失效
STATIC_ROOT 没配或配错，collectstatic 就不会把文件真正拷到目标位置，生产环境必然 404 —— 这不是 Django bug，是部署漏了关键一步。
常见错误写法：STATIC_ROOT = BASE_DIR / "static"，这和 STATICFILES_DIRS 里的 BASE_DIR / "static" 完全重叠，collectstatic 会尝试把自己拷进自己，轻则报错，重则覆盖源文件。
- 正确路径必须唯一、空、可写，比如
BASE_DIR / "staticfiles"或BASE_DIR / "cdn-static" - Linux 下确认权限：
sudo chown -R www-data:www-data /path/to/staticfiles（Nginx + uWSGI 场景） - Django 不会自动创建该目录，也**不检查是否存在或可写**，得你手动建好再运行
collectstatic
Web 服务器没指向 STATIC_ROOT 的真实路径
Nginx/Apache/宝塔面板里写的 location /static/，如果指向的是项目源码里的 static/ 目录，而不是 STATIC_ROOT 对应的磁盘路径，那 collectstatic 白跑一趟，文件根本不会被服务到。
典型 Nginx 配置错误：alias /myproject/static/; → 正确应为：alias /myproject/staticfiles/;（假设 STATIC_ROOT = BASE_DIR / "staticfiles"）
-
alias后路径末尾**必须带斜杠**，否则匹配失败 - 用
curl -I http://yourdomain/static/admin/css/base.css直接测响应头，看是否返回 200 和正确Content-Type - 别信浏览器缓存，用
curl或隐身窗口验证
DEBUG=False 时仍依赖开发服务器服务静态文件
DEBUG=False 后，Django **彻底放弃**通过 runserver 提供静态文件，urls.py 里加的 static(...) 路由完全失效。此时唯一生效路径就是 Web 服务器直连 STATIC_ROOT。
- 开发阶段可以靠
DEBUG=True+STATICFILES_DIRS临时调试，但上线前必须切到DEBUG=False -
INSTALLED_APPS中必须有'django.contrib.staticfiles'，否则collectstatic命令压根不存在 - 模板里必须先写
{% load static %}，再用{% static 'js/main.js' %}，硬编码/static/...在 CDN 或子路径部署时会崩
前端构建产物没纳入 collectstatic 流程
React/Vue 项目打包后生成的 build/static/ 目录，如果不告诉 Django 去哪儿找，collectstatic 就不会把它收进去。
比如 Vue CLI 构建输出在 clientApp/build/static/，就得把它加进 STATICFILES_DIRS：
STATICFILES_DIRS = [
BASE_DIR / "static",
BASE_DIR / "clientApp" / "build" / "static",
]
- 顺序很重要：
collectstatic按列表顺序扫描，同名文件会被后面目录的覆盖 - 执行前确保已运行
cd clientApp && npm run build，否则build/static目录为空 - 用
python manage.py findstatic --verbosity 2 js/main.js查看 Django 找到了哪些同名文件
os.path.join(BASE_DIR, '/static') 开头的 / 让它变成系统根目录下的 /static，而不是项目内；还有 Linux 下文件名大小写敏感，Logo.png 和 logo.png 是两个文件。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
