Django后台新增模型实例触发FileNotFoundError问题求助

错误现象 #

在Django后台添加Image模型实例时，触发如下错误：

FileNotFoundError at /admin/appname/modelname/add/
[Errno 2] No such file or directory: /home/user/PycharmProjects/myproject/media/file_I_wanna_upload.file

该路径是模型实例保存后文件应存放的绝对路径，但实际不存在。

相关配置与代码 #

settings.py配置 #

MEDIA_ROOT = 'media'
MEDIA_URL = '/media/'

项目urls.py配置 #

from django.conf import settings
from django.conf.urls.static import static
from django.contrib import admin
from django.urls import path, include


urlpatterns = [
                  path('admin/', admin.site.urls),
                  ...
              ] + static(settings.MEDIA_URL,
                         document_root=settings.MEDIA_ROOT
                         )

Image模型代码 #

from PIL import Image as I

class Image(models.Model):
    galery = models.ForeignKey(Galery, on_delete=models.CASCADE)
    image = models.ImageField(upload_to='photos')

    def save(self, *args, **kwargs):
        img = I.open(self.image.path)
        img.resize(size=(300, 300))
        img.save(self.image.path)
        return super(Image, self).save(*args, **kwargs)

对比可用的UserProfile模型 #

class UserProfile(models.Model):
    user = models.OneToOneField(CustomUser, related_name='userprofile', on_delete=models.CASCADE)
    username = models.CharField(max_length=30, unique=True)
    slug = models.SlugField(unique=True)
    first_name = models.CharField(max_length=30)
    last_name = models.CharField(max_length=30)
    avatar = models.ImageField(default="default.png", upload_to='avatars', blank=True)
    description = models.TextField(max_length=10 ** 4, blank=True)

    def __str__(self):
        return self.username

    def save(self, *args, **kwargs):
        self.slug = slugify(self.username)
        return super().save(*args, **kwargs)

问题原因与解决方法 #

核心问题 #

你在Image模型的save方法里，先尝试打开并修改图片，再调用父类的save方法，但此时图片还没有被Django保存到MEDIA_ROOT指定的路径下，所以self.image.path对应的文件不存在，触发FileNotFoundError。

而UserProfile模型的save方法是先调用父类save完成文件存储，再做其他操作（生成slug），所以没有这个问题。

修复步骤 #

1. 调整save方法执行顺序：先调用父类save确保文件已保存到磁盘，再处理图片
2. 注意resize方法返回新的Image对象，需接收该对象再保存，否则原图片不会被修改

修改后的Image模型代码：

from PIL import Image as I
import os
from django.conf import settings

class Image(models.Model):
    galery = models.ForeignKey(Galery, on_delete=models.CASCADE)
    image = models.ImageField(upload_to='photos')

    def save(self, *args, **kwargs):
        # 先调用父类save，确保文件已写入磁盘
        super().save(*args, **kwargs)
        
        # 拼接图片绝对路径，避免相对路径问题
        img_full_path = os.path.join(settings.MEDIA_ROOT, self.image.name)
        img = I.open(img_full_path)
        # 接收resize后的新图片对象
        resized_img = img.resize((300, 300))
        resized_img.save(img_full_path)

额外优化建议 #

• MEDIA_ROOT建议使用绝对路径，避免因项目运行目录变化导致路径错误：

  import os
  MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
  

• 可添加异常捕获逻辑，避免因图片格式损坏等问题导致save流程中断。

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