Django静态文件无法加载，添加配置后页面持续加载并报错

问题根源 #

你在DEBUG模式下错误地将static()的document_root指向了STATIC_ROOT，而STATIC_ROOT是生产环境执行collectstatic后存放静态文件的目录，DEBUG模式下Django会直接从STATICFILES_DIRS读取静态资源，这个配置冲突导致了请求阻塞和管道中断错误。

修复步骤 #

1. 修改urls.py中的静态文件配置 #

把指向STATIC_ROOT的代码调整为以下两种方式之一：

if settings.DEBUG:
    # 方法一：去掉document_root，让Django自动从STATICFILES_DIRS查找资源
    urlpatterns += static(settings.STATIC_URL)
    # 方法二：明确指向STATICFILES_DIRS的路径
    # urlpatterns += static(settings.STATIC_URL, document_root=settings.STATICFILES_DIRS[0])
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

2. 验证目录结构 #

确保项目根目录下存在static文件夹（与STATICFILES_DIRS配置一致），并存放了css、js、图片等静态资源；staticfiles目录无需手动创建，执行collectstatic时会自动生成。

3. 重启开发服务器 #

关闭当前运行的Django服务器，重新执行python manage.py runserver，再访问页面即可恢复正常。

额外说明 #

• STATIC_ROOT仅用于生产环境，部署项目时执行python manage.py collectstatic，所有静态资源会被收集到该目录，由Nginx或Apache等服务器提供服务。
• DEBUG模式下，Django内置的静态文件服务会自动扫描STATICFILES_DIRS和各app下的static目录，无需手动指定document_root。

内容的提问来源于stack exchange，提问作者Neo_77cyber