Django应用上传文件后点击查看/下载按钮无法打开页面求助

核心问题定位 #

• 路径重复拼接：Django的FileField字段自带的url属性默认已经拼接了MEDIA_URL前缀，模板中额外拼接MEDIA_URL会生成media/media/文件名格式的错误路径，是本次故障的主要原因
• MEDIA_URL配置不规范：未以斜杠开头的MEDIA_URL属于相对路径，在多级路由页面访问时会出现路径拼接错误

修复步骤 #

1. 修改HTML模板路径 #

直接使用文件字段自带的url属性，无需手动拼接MEDIA_URL：

<a href="{{ post.file_field.url }}" class="btn btn-warning" target="_blank">View</a>
                
<a href="{{ post.file_field.url }}" class="btn btn-info mx-4" download>Download</a>

2. 修正settings.py的MEDIA_URL配置 #

将MEDIA_URL改为以斜杠开头的绝对路径，避免相对路径拼接错误：

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

3. 可选排查项（修改后仍无法访问时校验） #

• 检查settings.py中TEMPLATES配置项的context_processors列表是否包含django.template.context_processors.media，确保模板可以正常读取媒体相关变量
• 若当前为DEBUG=False的生产环境，Django默认不处理媒体文件，需配置Nginx/Apache等Web服务器将/media/路径映射到本地MEDIA_ROOT目录
• 检查项目根目录下media文件夹的读写权限，确保运行Django服务的用户拥有该目录的访问权限

验证方法 #

修改完成后重启Django服务，鼠标悬浮在查看/下载按钮上，浏览器底部显示的路径应为http://你的服务地址/media/文件名格式，即可正常访问。

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