Django Nginx+Gunicorn部署后Admin上传400错误及媒体路径异常排查
核心问题根因
- 你完全用反了Django
upload_to参数的设计规则。这个参数的作用就是返回相对于MEDIA_ROOT的相对路径,Django会自动把MEDIA_ROOT拼在前面作为文件的实际存储绝对路径,同时自动把MEDIA_URL拼在前面生成文件的访问URL。你现在在回调函数里硬把MEDIA_ROOT的绝对路径拼进去,最终会导致两个连锁问题:- 实际存储路径变成嵌套两层的
/var/www/domain/media/var/www/domain/media/images/xxx.png,和你预期的存储位置完全错位 - 生成的访问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用户可以正常读写上传目录,避免因为写文件权限不足触发错误。
- 检查Django的
清理历史脏数据
因为之前的错误上传逻辑已经往数据库里存了一堆带绝对路径的ImageField值,需要把这些老值修正为对应的相对路径,不然已经上传的老图片还是会有URL错误的问题。
内容的提问来源于stack exchange,提问作者TheBenimeni
相关产品推荐
相关产品推荐

