当 Django 项目的 DEBUG 从 True 切换为 False 后，最常见的问题就是静态文件（CSS、JS、图片）加载失败，浏览器控制台报 404。不少开发者第一反应是修改 STATIC_URL 或 STATIC_ROOT，但问题根源往往不止于此。下面结合排查顺序和配置要点，整理一份可操作的备忘。
先理解 DEBUG=False 做了什么
当 Django 的 DEBUG 设置为 False 时，开发服务器不再自动提供静态文件服务。这是因为 Django 的开发模式假定生产环境中由 Nginx 或 Apache 等 Web 服务器直接处理静态资源。若未单独配置，浏览器请求的 CSS、JS 等文件将返回 404 错误。很多人在本地调试时习惯用 runserver 直接加载静态文件，一旦关闭 DEBUG 就会碰到这个门槛。理解这个行为变化，才能避免在错误的方向上浪费时间。
生产环境的标准做法：collectstatic + 反向代理
在生产环境中，推荐使用 collectstatic 命令将所有静态文件收集到 STATIC_ROOT 指定的目录，然后在 Web 服务器（如 Nginx）中配置该目录的静态文件路由。例如在 Nginx 的 location /static/ 块中设置 alias /path/to/staticfiles;，并确保 STATIC_URL 与 alias 路径一致。这个流程是 Django 官方推荐的生产方式，可以让 Web 服务器直接处理静态文件，避免 Django 处理性能低的请求。执行 python manage.py collectstatic 后，务必检查 STATIC_ROOT 目录下是否生成了需要的文件。如果文件不全，检查 STATICFILES_DIRS 是否包含了所有静态文件夹的路径。
开发环境临时方案：serve 视图的用法与风险
如果仅在开发阶段需要测试 DEBUG=False 下的静态文件加载，可以临时启用 django.views.static.serve 视图。在 urls.py 中添加 from django.conf import settings 和 from django.conf.urls.static import static，然后在 urlpatterns 后拼接 + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)。注意这仅应在开发环境中使用，生产环境仍需独立 Web 服务器。这个方案适用于本地想要模拟生产关闭 DEBUG，但又不想启动 Nginx 的场景。使用时需要先运行 collectstatic 把文件收集到 STATIC_ROOT 目录，否则 document_root 指向的路径可能为空。
常见遗漏：collectstatic 未执行或路径不匹配
许多开发者忘记运行 collectstatic 命令，导致 STATIC_ROOT 目录为空。请确保在运行该命令前已正确配置 STATIC_ROOT 和 STATICFILES_DIRS。此外，STATIC_URL 必须以斜杠结尾（如 '/static/'），否则静态资源路径拼接可能出错。如果使用临时 serve 视图，还要检查 STATIC_ROOT 的路径是否与 document_root 一致。另外，如果项目中有多个 app 的静态文件同名，collectstatic 默认会覆盖，需要留意 STATICFILES_STORAGE 的配置避免冲突。
验证方法：看请求、查文件、用命令定位
当静态文件无法加载时，可通过浏览器的开发者工具查看网络请求的状态码。如果返回 404，检查请求的 URL 与 STATIC_URL 是否匹配，并确认文件存在于 STATIC_ROOT 目录中。在终端运行 python manage.py findstatic yourfile.css 可显示 Django 查找静态文件的路径，帮助定位配置错误。结合这两个检查点，一般能快速定位问题是出在路由、收集还是路径上。如果使用 Nginx，还要检查 Nginx 的 error.log 确认 alias 路径是否正确。
风险提示：serve 视图不能用于生产
在 DEBUG=False 时启用 django.views.static.serve 存在安全风险，因为它会暴露所有静态文件，并可能导致任意文件读取漏洞。此功能仅限本地开发，切勿用于生产环境。确保生产环境中关闭该视图，并严格仅由 Web 服务器处理静态资源。如果项目部署在云服务器上，可以考虑使用 CDN 或对象存储来托管静态文件，这比自建 Nginx 更省心，但同样需要 collectstatic 上传到对应位置。
最后，静态文件配置问题通常都出在三个环节：收集（collectstatic）、路由（STATIC_URL + urlpatterns 或 Nginx location）、文件存在性（STATIC_ROOT 目录内容）。按顺序排查，每一步都确认到位，一般都能解决。如果问题依旧，检查 Django 版本是否有相关 bug，或者确认是否使用了自定义的存储后端。通常官方文档的静态文件部分足以覆盖多数场景，不必过度依赖第三方教程。