Django图书系统：锚标签下载失效及图片无法显示问题求助

问题根源 #

1. 模板中直接引用ImageField/FileField字段本身，未调用其url属性，浏览器无法获取完整的媒体文件访问路径
2. 项目未配置媒体文件的访问路由，导致Django无法映射上传文件的物理路径

解决方案 #

1. 修正模板代码 #

将模板中图片和文件的引用改为字段的url属性，同时修正图片高度的拼写错误（50p→50px），并添加空值判断避免404错误：

<td>
  {% if book.book_image %}
    <img src="{{ book.book_image.url }}" alt="{{ book.book_name }}" width="60px" height="50px">
  {% else %}
    <span>无封面</span>
  {% endif %}
</td>
<td>{{ book.book_name }}</td>
<td>{{ book.author_name }}</td>
<td>{{ book.subject }}</td>
<td>
  {% if book.file %}
    <a href="{{ book.file.url }}" download>Download</a>
  {% else %}
    <span>无下载文件</span>
  {% endif %}
</td>

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

在项目的settings.py中添加以下配置，指定媒体文件的存储根目录和访问URL：

import os

BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

# 媒体文件配置
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
MEDIA_URL = '/media/'

Django会自动在media目录下创建images/和files/子文件夹（对应models中upload_to的设置）。

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

在项目根目录的urls.py中，添加媒体文件的访问路由映射：

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

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

# 开发环境下的媒体文件路由
if settings.DEBUG:
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

注意：生产环境下请勿使用此配置，需通过Nginx/Apache等Web服务器直接处理媒体文件的静态访问。

4. 额外检查项 #

• 确保media目录具备读写权限，Django能正常写入上传文件
• 确认数据库中对应的book_image和file字段已正确存储文件路径

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