Django中{% load static %}标签无法显示图片问题排查

1. 模板语法错误（最直接原因） #

你的模板中static标签存在语法错误：

<img src="{% static 'myapp/mini.jpg}" alt="My image"/>

这里的单引号未闭合，正确写法应为：

<img src="{% static 'myapp/mini.jpg' %}" alt="My image"/>

这个错误会导致Django无法正确生成静态文件的URL，浏览器自然无法找到图片资源。

2. Settings配置的问题 #

（1）STATIC_ROOT与STATIC_URL冲突 #

STATIC_ROOT是部署阶段用来收集所有app静态文件的目录，开发环境下（DEBUG=True）无需配置该参数，或者应将其设置为与STATICFILES_DIRS不同的路径，例如：

STATIC_ROOT = BASE_DIR / 'staticfiles'

若开发时让STATIC_ROOT和STATIC_URL指向同一目录，会干扰Django对静态文件的查找逻辑。

（2）STATICFILES_DIRS使用相对路径 #

相对路径可能因运行Django命令的目录不同而失效，建议改用绝对路径：

from pathlib import Path

BASE_DIR = Path(__file__).resolve().parent.parent

STATICFILES_DIRS = [
    BASE_DIR / 'myapp/static',
]

（3）确认图片实际存放路径 #

请确保图片存放在myapp/static/myapp/mini.jpg位置——Django的静态文件规范是在app的static目录下创建与app同名的子目录，用于存放该app的静态资源，以此避免不同app的静态文件重名冲突。

内容的提问来源于stack exchange，提问作者Ayodele Martins Abiwo