Django3.0表单上传文件URL异常致404，求助问题排查

嘿，我完全理解你的困惑——毕竟同样的配置在几十个站点都正常，突然遇到这个问题肯定挠头。咱们一步步来梳理排查方向：

1. 优先检查视图的文件保存逻辑 #

后台管理页面用的是Django Admin的默认处理，会自动遵循upload_to规则生成完整路径并正确存入模型字段。但自定义表单的视图很可能是问题所在：

• 如果你是手动赋值文件字段而非使用ModelForm.save()，比如写了类似：

  obj = MyModel()
  obj.avatar = request.FILES.get('avatar')
  obj.save()
  

  这种写法可能会跳过Django对upload_to的自动处理，导致模型字段只存入文件名而非完整路径。正确的做法应该使用ModelForm，或者手动调用字段的save()方法：

  from django.core.files.base import ContentFile
  
  file = request.FILES['avatar']
  obj.avatar.save(file.name, ContentFile(file.read()), save=False)
  obj.save()
  

2. 核对数据库中字段的存储值 #

既然文件已经被正确存入media/2020/avatar/1.jpg，那先去数据库里查看对应模型的字段值：

• 如果字段存的是1.jpg而非2020/avatar/1.jpg，说明保存时没有让Django生成完整的相对路径，问题出在视图或模型的保存逻辑；
• 如果字段值是正确的完整路径，但前端显示的URL还是media/1.jpg，那就要检查模板渲染时的代码，是不是手动拼接了URL而非直接调用{{ obj.avatar.url }}。

3. 检查模型的自定义保存方法或信号 #

有没有给模型写过自定义的save()方法，或者注册了pre_save/post_save信号？

• 比如某些自定义逻辑可能会修改FileField的name属性，导致存入数据库的路径被截断；
• 对比Admin保存和表单保存时的信号触发情况，Admin可能会跳过某些自定义逻辑，而表单提交时触发了。

4. 确认表单的渲染与提交配置 #

虽然文件能上传到正确目录，还是快速确认下：

• 表单标签是否添加了enctype="multipart/form-data"？没有这个属性的话文件根本传不上去，不过你这里文件能上传，大概率没问题，但还是排除下；
• 表单类中对应的FileField/ImageField有没有被错误地设置了widget或其他属性，导致文件信息传递异常。

5. 查看日志定位细节 #

• 查看Nginx的access.log，确认404请求的具体路径是不是/media/1.jpg，这能验证我们对URL错误的判断；
• 查看Gunicorn的日志，看看视图处理文件保存时有没有报错或者异常信息，比如路径处理的警告。

6. 排除缓存干扰 #

有时候浏览器缓存或Django的模板缓存会导致旧的URL显示，试试：

• 用无痕模式打开页面查看URL；
• 执行python manage.py clearcache清理Django缓存（如果启用了缓存）。

内容的提问来源于stack exchange，提问作者Amin.B