Django 5.1无法加载static静态文件但media正常，求排查方案

核心问题分析 #

DEBUG模式下Media文件可正常访问，但Static文件返回404，新建空白项目也复现该问题，大概率是静态文件查找路径配置缺失导致的——Django在DEBUG模式下默认不会从STATIC_ROOT读取静态文件，而是依赖STATICFILES_DIRS或各App内的static目录。

分步排查与修复 #

1. 修正settings.py静态文件配置

当前配置仅设置了STATIC_ROOT（生产环境收集静态文件的目录），但未指定DEBUG模式下Django需要扫描的静态文件目录。修改如下：

STATIC_URL = 'static/'
# 新增：告诉Django扫描项目根目录下的static文件夹
STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static')]
# 建议修改STATIC_ROOT为独立目录，避免与源静态文件目录混淆
STATIC_ROOT = os.path.join(BASE_DIR, 'static_collect')
MEDIA_URL = 'media/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

• STATICFILES_DIRS：指定除App内部static目录外的额外静态文件存储路径
• STATIC_ROOT：仅用于生产环境，执行python manage.py collectstatic后，所有静态文件会被收集到该目录

2. 确认静态文件存放位置

确保favicon.ico等静态文件存放在项目根目录的static文件夹下，而非某个App的static目录（除非你想让该文件仅属于某个App）。

3. 修复Admin模板的HTML转义问题

你的自定义admin/base.html中使用了HTML转义字符（<、"），这会导致浏览器无法解析为有效HTML标签，修正为：

{% extends 'admin/base.html' %}

{% load static %}

{% block extrahead %}
  <link rel="shortcut icon" href="{% static 'favicon.ico' %}" />
{% endblock %}

4. 验证访问路径与缓存

• 直接访问静态文件URL：http://localhost:8000/static/favicon.ico，确认是否返回404
• 若仍无法访问，尝试硬刷新浏览器（Ctrl+F5）清除缓存，或重启Django开发服务器

5. 检查DEBUG状态

确保settings.py中DEBUG = True，否则Django不会自动处理静态文件请求（即使你在urls.py中添加了static()配置）。

空白项目测试验证 #

新建空白项目后，按以下步骤操作即可加载静态文件：

1. 在项目根目录创建static文件夹，放入favicon.ico
2. 在settings.py中添加STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static')]
3. 启动开发服务器，访问http://localhost:8000/static/favicon.ico即可正常加载

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