Django设置DEBUG=False后文件不上传至MEDIA_ROOT及媒体资源404问题

问题1：图片上传路径错误的原因 #

你在settings.py中错误将MEDIA_ROOT配置为和STATICFILES_DIRS完全相同的BASE_DIR/static路径，二者路径冲突直接导致上传的媒体文件被写入静态文件目录。

问题2：媒体文件404的原因 #

1. Django自带的static()路由辅助方法仅在DEBUG=True时生效，切换为生产模式后媒体访问路由直接失效
2. 你使用的whitenoise默认仅处理STATIC_ROOT下的静态资源，用户上传的媒体文件不在其处理范围内，因此CSS、JS可正常访问但媒体文件无法加载
3. 之前存储在STATICFILES_DIRS下的媒体文件，执行collectstatic时仅会被复制到STATIC_ROOT，但后续新上传的文件不会被自动纳入静态资源处理范围

分步修复方案 #

第一步：修正settings.py配置 #

修改媒体文件存储路径，和静态文件目录完全隔离：

# 原有静态配置保留不动，仅修改MEDIA相关配置
MEDIA_URL = '/media/'
# 单独创建media目录存储用户上传的文件，不要和static目录混用
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

修改后需要手动在项目根目录创建media文件夹，并给与Web服务进程写入权限，同时将之前上传到static目录下的媒体文件手动迁移到media对应子目录中。

第二步：修复生产环境媒体路由 #

Django官方不推荐在生产环境用Django本身处理媒体文件，性能最优的方案是在部署的Web服务器（Nginx/Apache）中配置媒体路径映射：
以Nginx为例，在站点配置中添加以下规则即可：

location /media/ {
    alias /path/to/your/project/media/;
    expires 30d; # 可添加缓存规则提升访问速度
}

如果你临时需要在DEBUG=False时用Django直接处理媒体访问（仅推荐临时调试用，不建议生产环境使用），可以手动添加永久生效的媒体路由到urls.py：

from django.urls import re_path
from django.views.static import serve
from django.conf import settings

urlpatterns = [
    # 原有路由保留
    re_path(r'^media/(?P<path>.*)$', serve, {'document_root': settings.MEDIA_ROOT}),
]
# 原有的static()添加的路由可以保留，不影响

可选：用whitenoise处理媒体文件（不推荐） #

如果你一定要用whitenoise处理媒体文件，可以将媒体路径配置到静态资源目录下：

MEDIA_URL = '/static/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'staticfiles', 'media')

该配置下媒体文件会被whitenoise识别处理，但需要注意每次执行collectstatic不会覆盖已上传的媒体文件，安全性和性能远低于Web服务器直接处理。

内容的提问来源于stack exchange，提问作者Sumeth Sathnindu