django imagefield 上传失败主因是未配置媒体文件服务：开发时需在url中添加static(settings.media_url, document_root=settings.media_root)（仅debug=true），生产环境须由nginx等通过alias映射media_url到media_root，并确保权限正确。
ImageField 上传失败：文件没存到 MEDIA_ROOT，浏览器访问 404
根本原因是 Django 不会自动把上传的图片文件“复制”到 MEDIA_ROOT 对应的物理路径里——它只在数据库里记下相对路径（比如 "uploads/cat.jpg"），而你必须确保 Web 服务器（如 Nginx 或开发用的 runserver）能从这个路径读取真实文件。
开发阶段最常漏掉这一步：没在 URL 配置里暴露 MEDIA_URL 对应的静态文件服务。Django 默认不提供媒体文件服务，除非你显式加上：
from django.conf import settings from django.conf.urls.static import static <p>urlpatterns = [</p><h1>你的其他路由...</h1><p>]</p><p>if settings.DEBUG: urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)</p>
注意：这段代码只能加在开发环境（DEBUG=True），生产环境必须由 Nginx/Apache 直接映射 MEDIA_URL 到 MEDIA_ROOT，否则有安全风险。
ImageField 字段保存后，文件实际存在哪？
ImageField 本身不处理存储逻辑，它依赖 Django 的 Storage 后端。默认用的是 django.core.files.storage.FileSystemStorage，它的行为是：
- 根据
upload_to参数拼出子路径（支持字符串或可调用对象） - 把文件写入
MEDIA_ROOT+upload_to拼出的路径 - 数据库中只存这个拼出来的相对路径（不含
MEDIA_ROOT）
例如：
class Article(models.Model):
photo = models.ImageField(upload_to="articles/%Y/%m/")
上传一张图时，如果今天是 2024 年 6 月 15 日，文件会被存到：MEDIA_ROOT/articles/2024/06/filename.jpg，数据库字段值则是 "articles/2024/06/filename.jpg"。
常见错误：
-
upload_to写成绝对路径（如"/var/www/uploads/"）→ Django 会把它当相对路径，最终存到MEDIA_ROOT下的/var/www/uploads/子目录 -
MEDIA_ROOT路径末尾没加/，而upload_to开头也没加 → 可能导致路径粘连（如MEDIA_ROOT="/opt/myapp/media"+upload_to="img"→ 实际路径变成/opt/myapp/mediacat.jpg）
为什么 form.save() 后图片文件没生成？
不是所有表单提交都会触发文件保存。关键看三点：
- HTML 表单有没有
enctype="multipart/form-data"—— 缺了就根本传不上文件 - 视图里是否用了
request.FILES初始化 form：form = MyForm(request.POST, request.FILES)—— 忘传request.FILES，ImageField就收不到数据 - 模型字段是否设置了
blank=True或null=True，但表单校验又没通过 →form.is_valid()返回False，save()根本不会执行
调试建议：在视图里加一行打印：
print("FILES:", request.FILES) # 看有没有 key 对应你的 ImageField name
print("form.errors:", form.errors)
如果 request.FILES 是空字典，先检查前端表单；如果 form.errors 显示 photo: This field is required.，再确认字段是否允许为空、是否被排除在 fields 外。
部署到生产环境后图片打不开
开发时靠 runserver 加 static(...) 能凑合，但生产环境用 Gunicorn/Uvicorn 时，它们根本不处理静态/媒体文件。这时候必须让反向代理（Nginx）接管：
Nginx 配置片段示例（假设 MEDIA_URL = "/media/"，MEDIA_ROOT = "/var/www/myproject/media"）：
location /media/ {
alias /var/www/myproject/media/;
}
注意：alias 末尾的 / 很关键 —— 它会让 /media/cat.jpg 映射到文件系统 /var/www/myproject/media/cat.jpg。如果写成 root，路径拼接规则完全不同，极易 404。
另一个易忽略点：MEDIA_ROOT 目录权限。Gunicorn 进程用户（如 www-data）必须对这个目录有读写权限，否则上传会静默失败（日志里可能只有 Permission denied 错误）。
最后提醒一句：Django 的 ImageField 不会自动压缩或调整尺寸，上传大图直接存原图。真要处理，得在 save() 里手动调用 PIL，或者用 django-imagekit 这类库 —— 但这已经超出上传配置本身了。
