You need to enable JavaScript to run this app. Django Nginx+Gunicorn部署后Admin上传400错误及媒体路径异常排查
优惠活动
大模型
产品
解决方案
定价
更多

Django Nginx+Gunicorn部署后Admin上传400错误及媒体路径异常排查

核心问题根因
  • 你完全用反了Django upload_to参数的设计规则。这个参数的作用就是返回相对于MEDIA_ROOT的相对路径,Django会自动把MEDIA_ROOT拼在前面作为文件的实际存储绝对路径,同时自动把MEDIA_URL拼在前面生成文件的访问URL。你现在在回调函数里硬把MEDIA_ROOT的绝对路径拼进去,最终会导致两个连锁问题:
    1. 实际存储路径变成嵌套两层的/var/www/domain/media/var/www/domain/media/images/xxx.png,和你预期的存储位置完全错位
    2. 生成的访问URL变成/media/var/www/domain/media/images/xxx.png,和Nginx的规则完全对不上
  • Nginx的media匹配规则写错了。你用了location = /media/的精确匹配,只会拦截完全等于/media/的请求,所有带层级的媒体文件请求(比如/media/images/xxx.png)根本进不到这个处理块,会被转发给Gunicorn,而你现在DEBUG是关闭状态,Django根本没有处理静态媒体的路由能力,自然会出问题。
  • 你遇到的400 Bad Request本质是两个原因叠加:一是嵌套的错误存储路径没有提前创建,www-data用户没有对应目录的写权限,上传时写文件失败;二是DEBUG关闭后ALLOWED_HOSTS没配置正确,Django直接拦截请求返回400。
  • 你之前自己写的那行URL字符串替换的逻辑,是为了修正路径错误打出来的临时补丁,根本不是长期方案,反而会因为路径匹配规则的问题引入更多bug。
  • 你的urls.py静态路由配置是符合Django设计的:只有DEBUG开启时才会加载内置的静态处理逻辑,生产环境DEBUG关闭后,这些路由不会生效,完全靠Nginx处理静态文件,这部分不需要调整。
分步修正方案
  • 重写upload_to的回调逻辑
    删掉原来拼MEDIA_ROOT的错误代码,只返回纯相对路径即可:

    # 修正前的错误代码
    def get_path_of_content_image(instance, filename):
        return os.path.join(settings.MEDIA_ROOT, "images", str(instance.course.topic), str(instance.course), filename)
    
    # 修正后的正确代码
    def get_topic_profile_path(instance, filename):
        # 不需要拼MEDIA_ROOT,Django会自动拼接成实际存储路径
        return os.path.join("images", str(instance.topic), str(instance), filename)
    

    改完之后,Django会自动把文件存到MEDIA_ROOT + 返回的相对路径,也就是你预期的/var/www/domain/media/images/xxx/xxx.png,同时生成的图片URL会自动是/media/images/xxx/xxx.png的正确格式——这时候你就可以把之前那行手动替换URL的get_image逻辑直接删掉了,self.image.url本身就是可用的。
    你之前测试写相对路径发现文件存错位置,本质是之前的错误函数里硬拼了MEDIA_ROOT,只要把那部分拼接逻辑删掉,Django会严格按照你配置的MEDIA_ROOT来存文件,不会把文件写到项目目录下的media文件夹里。

  • 修正Nginx的媒体路径匹配规则
    把原来的精确匹配改成前缀匹配,让所有/media/开头的请求都被Nginx直接处理:

    # 修正前的错误配置
    location = /media/ {
        root /var/www/domain;
    }
    
    # 修正后的正确配置
    location /media/ {
        root /var/www/domain;
    }
    

    按照Nginx的root拼接规则,收到/media/images/xxx.png的请求时,Nginx会自动查找对应/var/www/domain/media/images/xxx.png的实际文件,和你的媒体目录结构完全对应。

  • 排查400错误的触发点

    • 检查Django的ALLOWED_HOSTS配置,DEBUG关闭后必须把你的域名、服务器IP都加进去,否则Django会直接返回400拒绝请求。
    • 给媒体目录配全权限:执行chown -R www-data:www-data /var/www/domain/media,确保运行Gunicorn的www-data用户可以正常读写上传目录,避免因为写文件权限不足触发错误。
  • 清理历史脏数据
    因为之前的错误上传逻辑已经往数据库里存了一堆带绝对路径的ImageField值,需要把这些老值修正为对应的相对路径,不然已经上传的老图片还是会有URL错误的问题。

内容的提问来源于stack exchange,提问作者TheBenimeni

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 22:54:07