Django上传图片未保存到media文件夹的配置问题求助

1. 修正settings.py配置错误 #

• 调整BASE_DIR的定义顺序，必须在所有依赖BASE_DIR的配置项之前定义
• 修正MEDIA_URL为绝对路径格式，禁止使用相对路径
• 补充缺失的STATIC_ROOT配置（urls.py中已引用该变量）
  修改后完整配置如下：

# 放在配置最开头最先定义
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

STATIC_URL = '/static/'
# 开发阶段静态文件查找路径
STATICFILES_DIRS = [os.path.join(BASE_DIR, "static")]
# 执行collectstatic命令后静态文件的统一输出路径，必填
STATIC_ROOT = os.path.join(BASE_DIR, "staticfiles")

MEDIA_ROOT = os.path.join(BASE_DIR, "media")
# 必须以/开头和结尾，是访问媒体文件的固定url前缀
MEDIA_URL = '/media/'

2. 修正models.py的ImageField配置 #

upload_to参数的路径是相对于MEDIA_ROOT的相对路径，不需要写父级跳转符，也不需要重复声明media路径：

profile_image = models.ImageField(upload_to="images")

修改后上传的图片会自动匹配你的现有目录结构，保存到media/images文件夹下。

3. 确认urls.py配置生效 #

已写的静态/媒体文件映射逻辑无需修改，但要确认这段代码是添加在**项目根urls.py（main文件夹下的urls.py）**中，而非app内部的urls.py。

4. 检查前端表单配置 #

上传文件的表单必须加上enctype属性，否则Django不会接收上传的文件资源：

<form method="post" enctype="multipart/form-data">
    {% csrf_token %}
    <!-- 其他表单字段 -->
    <input type="file" name="profile_image">
    <button type="submit">提交</button>
</form>

5. 检查文件夹权限 #

确认项目下的media/images文件夹有写入权限，Linux/Mac系统可执行命令赋权：

chmod 755 media/images

6. 生效配置 #

修改完模型后需要执行迁移命令更新数据库结构，之后重启开发服务即可：

python manage.py makemigrations
python manage.py migrate

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