Django问题：通过Admin后台自定义模型上传图片功能失效

问题根源分析 #

你的代码和配置存在以下几个关键问题，导致图片上传功能失效：

1. 缺少ImageField依赖库Pillow #

Django的models.ImageField依赖第三方库Pillow，未安装的话会触发后台表单渲染异常。

2. 未配置媒体文件存储路径与访问URL #

Django默认不会自动处理上传文件的存储和访问，必须在settings.py中配置MEDIA_ROOT和MEDIA_URL，否则无法正确保存和预览图片。

3. __str__方法存在致命错误 #

你的__str__方法写了多个return语句，程序只会执行第一个return self.image，而ImageField对象直接返回会导致Admin界面渲染异常（因为需要字符串类型）。

4. IntegerField错误使用max_length参数 #

models.IntegerField不需要max_length属性，这个参数是给CharField用的，多余的参数会引发配置警告，甚至影响表单渲染。

分步解决方法 #

1. 安装Pillow依赖 #

在项目虚拟环境中执行命令：

pip install pillow

2. 配置媒体文件相关设置 #

打开项目根目录的settings.py，添加以下配置：

# 媒体文件存储路径（建议在项目根目录创建media文件夹）
MEDIA_ROOT = BASE_DIR / 'media'
# 媒体文件访问URL前缀
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

urlpatterns = [
    path('admin/', admin.site.urls),
    # 其他路由...
]

# 开发环境下挂载媒体文件路由
if settings.DEBUG:
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

3. 修复__str__方法 #

修改models.py中的__str__方法，只保留一个有意义的字符串返回，比如返回鸟类品种：

def __str__(self):
    return self.breed

（如果需要多字段展示，可以拼接字符串，比如return f"{self.breed} - {self.price}"）

4. 移除IntegerField的max_length参数 #

修改models.py中age_in_years和age_in_months的定义：

age_in_years = models.IntegerField(help_text='Enter Age in Years')
age_in_months = models.IntegerField(help_text='Enter Age in Months')

验证修复 #

完成以上修改后：

1. 执行数据库迁移（因为修改了模型字段）：

python manage.py makemigrations
python manage.py migrate

2. 重启Django开发服务器，再次进入Admin后台尝试上传图片，即可正常使用。

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