Django开发服务器无法访问静态文件问题排查

嘿，看来你是把Django开发环境和生产环境的静态文件配置搞混啦！我帮你捋捋问题出在哪，以及怎么修复：

核心问题：STATIC_ROOT的使用场景错了 #

你配置的STATIC_ROOT = os.path.join(BASE_DIR, "static")，这个目录是生产环境下用的——只有当你运行python manage.py collectstatic命令时，Django才会把所有app里的静态文件、以及你配置的其他静态文件目录里的内容，统一收集到这个文件夹里，供Nginx/Apache等服务器部署用。

而在**开发环境（DEBUG=True）**下，Django默认不会从STATIC_ROOT里读取静态文件，它会去以下两个地方找：

• 各个app目录下的static文件夹
• STATICFILES_DIRS配置里指定的自定义静态文件目录

修复步骤 #

1. 配置STATICFILES_DIRS #

在你的settings.py里添加这一段，告诉Django开发时去哪里找你自定义的静态文件：

STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, "static")
# 新增这行
STATICFILES_DIRS = [os.path.join(BASE_DIR, "static")]

2. 确保DEBUG模式开启 #

确认settings.py里DEBUG = True，只有在DEBUG模式下，Django的开发服务器才会自动处理静态文件的路由。你urls.py里的+ static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)其实在DEBUG开启时，django.contrib.staticfiles已经帮你处理了（只要INSTALLED_APPS里包含这个app），不过保留也没问题。

3. 开发阶段别跑collectstatic #

开发时不需要运行collectstatic命令，这个是部署生产环境前才需要做的操作。你现在的静态文件已经放在项目根目录的static文件夹里，配置好STATICFILES_DIRS后，开发服务器就能找到它们了。

4. 模板里推荐用static模板标签（可选但更规范） #

把模板里的硬编码路径改成Django的static模板标签，这样更灵活，也能避免路径错误：

{% load static %} <!-- 一定要加在模板开头 -->
<link href="{% static 'bs4/css/cover.css' %}" rel="stylesheet">

额外排查点 #

• 检查BASE_DIR是否正确：在settings.py里加一行print(BASE_DIR)，运行开发服务器时看看输出的路径是不是你的项目根目录（就是包含static文件夹的那个目录），如果不对，可能是settings.py的位置导致BASE_DIR计算错误。
• 确认INSTALLED_APPS里包含django.contrib.staticfiles，这个是Django处理静态文件的核心app。

按照上面的步骤调整后，再重启开发服务器，应该就能正常加载静态文件啦！

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