在Django模板中通过FileField显示PDF文件遇阻求助

1. 验证媒体文件配置 #

• 确认settings.py中MEDIA_ROOT和MEDIA_URL配置正确：

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

• 在项目根urls.py中添加媒体文件路由（仅开发环境适用，生产环境需配置服务器静态文件映射）：

  from django.conf import settings
  from django.conf.urls.static import static
  
  urlpatterns = [
      # 你的其他路由
  ] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
  

• 检查上传的PDF文件是否实际存储在MEDIA_ROOT指定的目录下，路径无拼写错误。

2. 模板中正确渲染PDF #

• 必须使用模型实例的{{ object.file_field.url }}属性获取文件的完整访问路径，不能直接使用文件名。
• 使用<embed>或<iframe>标签嵌入PDF，示例代码：

  <!-- 使用embed标签 -->
  <embed 
    src="{{ pdf_obj.pdf_file.url }}" 
    type="application/pdf" 
    width="100%" 
    height="600px"
  >
  
  <!-- 或使用iframe标签 -->
  <iframe 
    src="{{ pdf_obj.pdf_file.url }}" 
    width="100%" 
    height="600px" 
    frameborder="0"
  ></iframe>
  

3. 模型与视图检查 #

• 模型中FileField定义需指定正确的upload_to路径：

  from django.db import models
  
  class PDFDocument(models.Model):
      pdf_file = models.FileField(upload_to='pdfs/')  # 文件会存在media/pdfs/目录下
  

• 视图需将模型实例传递到模板，比如使用DetailView：

  from django.views.generic import DetailView
  from .models import PDFDocument
  
  class PDFDetailView(DetailView):
      model = PDFDocument
      template_name = 'summary_pdf.html'
      context_object_name = 'pdf_obj'
  

4. 其他排查点 #

• 确认服务器对MEDIA_ROOT目录有读写权限，避免文件无法读取。
• 测试上传的PDF文件本身是否完整，可本地打开验证。
• 生产环境下，需配置Web服务器（如Nginx、Apache）处理媒体文件请求，不能依赖开发环境的static()方法。

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