Django模板中网页图片无法加载问题求助

问题场景 #

在Django项目中尝试加载静态图片时无法显示，相关配置与代码如下：

settings.py 配置 #

STATIC_URL = '/static/'
STATICFILES_DIRS = [
    BASE_DIR / "static",
]

模板文件（注：应为homepage.html，推测为笔误）代码 #

<html>
<head><title>project</title>
</head>
<body>
<div class="top">   
{% load static %}
<img src="{% static 'project1.jpg' %}">
<h1> FLIGHT</h1>
</div>
</body>
</html>

项目细节：虚拟环境为sem1 final，应用名为project，static文件夹位于项目根目录下，其中实际图片文件名为project1.jpeg。网页加载时Linux控制台出现橙色错误提示。

问题根源 #

模板中引用的图片后缀写为jpg，但实际文件后缀是jpeg，文件名不匹配导致服务器无法找到对应资源，最终触发加载失败。

解决步骤 #

1. 修正模板中的图片文件名：将模板里的project1.jpg改为project1.jpeg，修改后的代码如下：

<html>
<head><title>project</title>
</head>
<body>
<div class="top">   
{% load static %}
<img src="{% static 'project1.jpeg' %}">
<h1> FLIGHT</h1>
</div>
</body>
</html>

2. 清理浏览器缓存：避免浏览器缓存旧的资源路径，刷新页面重新加载。
3. 验证静态资源路径：可以通过访问http://localhost:8000/static/project1.jpeg（假设本地开发服务器端口为8000），确认图片能正常访问，确保STATIC相关配置生效。

额外排查提示 #

如果后续仍遇到静态资源加载问题，可检查：

• STATICFILES_DIRS是否正确指向static文件夹路径，可通过打印BASE_DIR确认路径是否正确
• 确认django.contrib.staticfiles已添加到INSTALLED_APPS中
• 开发环境下确保已运行python manage.py runserver，无需手动收集静态文件；生产环境需执行python manage.py collectstatic

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