从Django 4.2.6升级到5.0.6后表单功能失效求助

我使用ImageForm将图片上传至数据库并以base64格式存储（用户图标，仅少量像素），但升级后功能失效。相关代码如下：

class CustomImageFile(AdminFileWidget):
    def render(self, name, value, attrs=None, renderer=None):
        output = [super().render(name, value)]
        try:
            output.append(self.form_instance.instance.show_picture())
        except:
            pass
        return """".join([x for x in output])

class PersonAdminForm(forms.ModelForm):
    image_file = forms.ImageField(widget=CustomImageFile, required=False, label="picture")

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.fields["image_file"].widget.form_instance = self 

    class Meta:
        model = Person
        fields = ["name", ..., "image_file"]

@admin.register(Person)
class PersonAdmin(admin.ModelAdmin):
    list_display = ["get_name", "get_picture"]    

    @admin.display(description="...")
    def get_picture(self, obj):
        try:
            return obj.show_picture
        except: 
            return "... "

class Person(models.Model):
    name = models.CharField("name", max_length=128, blank=True, null=True)
    picture = models.TextField("asb64", blank=True)
    
    def show_picture(self):
        try:
            return format_html(f"""<img src="{self.picture}">""")     
        except:
            return ""

在Django 4.2.6和4.2.13版本中该功能正常，升级至5.0.6后图片预览无法显示。请问ImageField是否有相关变更？我未在补丁说明中找到可用信息，恳请提供解决方案。

1. 修复Widget渲染的字符串拼接问题 #

Django 5.0中AdminFileWidget.render()返回SafeString类型，直接拼接普通字符串会触发HTML转义，导致图片预览代码失效。需要将拼接后的内容标记为安全HTML：

from django.utils.safestring import mark_safe

class CustomImageFile(AdminFileWidget):
    def render(self, name, value, attrs=None, renderer=None):
        base_html = super().render(name, value, attrs, renderer)
        try:
            preview_html = self.form_instance.instance.show_picture()
            return mark_safe(f"{base_html}{preview_html}")
        except:
            return base_html

2. 修正Admin列表页的图片预览调用错误 #

原代码中get_picture方法返回的是方法对象而非执行结果，Django 5.0对显示字段的类型校验更严格，需改为调用方法：

@admin.display(description="...")
def get_picture(self, obj):
    try:
        return obj.show_picture()  # 添加()执行方法
    except: 
        return "... "

3. 确保图片转base64的逻辑正常运行 #

原代码缺少上传图片转base64并保存到picture字段的逻辑，需在表单中补充clean方法（如果之前有这部分逻辑，需确认在Django 5.0中兼容）：

import base64

class PersonAdminForm(forms.ModelForm):
    # ... 原有代码 ...
    def clean_image_file(self):
        image_file = self.cleaned_data.get("image_file")
        if image_file:
            # 读取图片并转为base64格式
            image_data = image_file.read()
            base64_str = base64.b64encode(image_data).decode('utf-8')
            # 拼接完整的data URI格式
            self.instance.picture = f"data:image/{image_file.content_type.split('/')[-1]};base64,{base64_str}"
        return image_file

4. 改用模板扩展Widget（备选方案） #

如果上述修改无效，可利用Django 5.0的Widget模板渲染机制，自定义模板扩展AdminFileWidget：

class CustomImageFile(AdminFileWidget):
    template_name = "admin/custom_image_file.html"

    def get_context(self, name, value, attrs):
        context = super().get_context(name, value, attrs)
        try:
            context["preview_html"] = self.form_instance.instance.show_picture()
        except:
            context["preview_html"] = ""
        return context

创建模板文件templates/admin/custom_image_file.html：

{{ block.super }}
{{ preview_html }}

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