Django项目中HTML img标签src路径返回404错误的求助

你的问题核心是没按照Django的媒体文件规则配置，直接用本地相对路径访问，Django开发服务器不会识别这些路径，所以返回404。按以下步骤修复：

1. 配置settings.py的媒体文件参数 #

打开项目根目录的settings.py，添加/修改以下配置：

from pathlib import Path

# 项目根目录
BASE_DIR = Path(__file__).resolve().parent.parent

# 媒体文件本地存储路径（对应你portfolio下的media文件夹）
MEDIA_ROOT = BASE_DIR / 'portfolio' / 'media'

# 媒体文件的URL访问前缀
MEDIA_URL = '/media/'

2. 配置项目urls.py的媒体路由 #

打开项目根目录的urls.py，添加媒体文件的路由规则：

from django.contrib import admin
from django.urls import path
from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    path('admin/', admin.site.urls),
    # 你的其他业务路由...
]

# 开发环境下启用媒体文件服务
if settings.DEBUG:
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

3. 在模板中正确引用图片 #

配置完成后，直接用媒体URL前缀访问即可：

<img src="/media/rockbrow.jpg" class="card-img-top" alt="PLACEHOLDER" />

或者用更规范的Django模板标签方式（需在模板开头加载{% load static %}）：

{% load static %}
<img src="{{ MEDIA_URL }}rockbrow.jpg" class="card-img-top" alt="PLACEHOLDER" />

为什么之前的路径都不行？ #

Django开发服务器只会处理urlpatterns中定义的路由，你之前用的相对路径（../../media/...）、绝对本地路径（/portfolio_site/mysite/...）都没有对应的路由规则，服务器无法找到文件，因此返回404。只有通过MEDIA_URL配置的路由，Django才会映射到MEDIA_ROOT对应的本地文件夹。

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