Django项目图片无法显示问题求助（附代码与报错信息）

一、先核对settings.py的静态文件配置 #

• 确认STATIC_URL设置正确，示例：STATIC_URL = '/static/'
• 检查STATICFILES_DIRS是否包含项目根目录下的static文件夹，配置如下：

STATICFILES_DIRS = [
    BASE_DIR / "static",
]

• 开发阶段务必保证DEBUG = True，因为DEBUG关闭后Django不会自动托管静态文件
• 若已部署到生产环境，需确认STATIC_ROOT已配置，且执行过python manage.py collectstatic将静态文件归集到指定目录

二、检查根urls.py的静态文件路由 #

开发环境下，必须在根urls.py中添加静态文件的访问路由，否则Django无法找到静态资源：

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # 你的业务路由配置
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

注意：该配置仅用于开发环境，生产环境需用Nginx/Apache等web服务器托管静态文件

三、修正HTML模板的图片引用方式 #

• 模板开头必须加载static标签：{% load static %}
• 图片引用必须通过static标签生成正确URL，示例：

<img src="{% static 'images/your_image.png' %}" alt="说明文字">

禁止直接写相对路径（如src="images/xxx.png"），否则会导致URL解析错误

四、如果是模型上传的图片（models.py） #

若图片是通过ImageField上传的，注意这类文件默认存在MEDIA_ROOT目录下，而非static文件夹：

• 在settings.py中配置媒体文件路径：

MEDIA_URL = '/media/'
MEDIA_ROOT = BASE_DIR / 'media'

• 根urls.py添加媒体文件路由：

urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

• 模板中引用上传的图片需用{{ 模型实例.image字段.url }}，而非static标签

五、排查文件路径与权限问题 #

• 确认static/images文件夹真实存在，图片文件名拼写完全匹配（Linux系统区分大小写）
• 检查文件权限：Linux/macOS下执行chmod -R 755 static/，确保Django进程有读取权限；Windows下右键文件夹选择「属性」，取消只读权限

六、结合报错Traceback精准定位 #

根据你提供的报错信息：

• 若为404 Not Found：重点检查URL配置和模板引用路径
• 若为PermissionDenied：优先排查文件权限设置
• 若为No such file or directory：确认文件夹或文件是否存在，路径是否正确

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