Django 5.1.2中表单类字典属性实例修改跨请求持久化的问题及最优修复方案

嘿，这个问题我太熟了！你碰到的是Python可变类属性在Django里的经典坑，咱们来一步步拆解解决它～

问题根源 #

你把contents定义成了MyForm的类属性，而字典是Python的可变对象。在Python中，类属性会被该类的所有实例共享——也就是说，当你在视图里执行form.contents.update(...)时，你并没有修改当前表单实例独有的字典，而是直接修改了MyForm类本身的contents字典。这样一来，后续所有请求创建的MyForm实例都会复用这个已经被修改过的字典，这就是为什么修改会跨请求持久化的原因。

最优修复方案 #

最规范且一劳永逸的方法是把contents改成实例属性，在表单的__init__方法里初始化，让每个表单实例都拥有自己独立的字典副本：

class MyForm(forms.Form):
    class Meta:
         fields = ('',)

    def __init__(self, *args, **kwargs):
        # 先调用父类的初始化方法
        super().__init__(*args, **kwargs)
        # 初始化当前实例独有的contents字典
        self.contents = {
            'icon' : 'img/some-icon.png',
            'title' : 'Description of form',
            'message' : 'Some instruction for user',
            'value' : 'text-label-of-the button',
        }

修改后，你视图里的代码完全不需要改动，还是可以像之前那样更新form.contents：

def myview(request):
    if request.method == 'GET':
        form = MyForm()
        form.contents.update({ 
            'icon' : 'img/wrong_red.png',
            'title' : 'You did it wrong',
            'color' : 'red',
            'message' : 'Something user did wrong',
            'value' : 'Cancel',
        })
        context = {'form' : form}
        return render(request, 'form.html', context)

现在每个表单实例的contents都是独立的，修改只会影响当前请求的实例，再也不会出现跨请求持久化的问题了。

备选临时方案（不推荐长期使用） #

如果暂时不想修改表单类的结构，也可以在视图里创建实例后，先拷贝类属性的字典，生成实例自己的副本再修改：

def myview(request):
    if request.method == 'GET':
        form = MyForm()
        # 拷贝类属性的字典，创建实例独有的副本
        form.contents = form.contents.copy()
        form.contents.update({ 
            'icon' : 'img/wrong_red.png',
            'title' : 'You did it wrong',
            'color' : 'red',
            'message' : 'Something user did wrong',
            'value' : 'Cancel',
        })
        context = {'form' : form}
        return render(request, 'form.html', context)

不过这种方法不够优雅，需要每次手动拷贝，容易遗漏，长期维护性不如第一种方案。

总结 #

把contents移到表单的__init__方法中作为实例属性，是最符合Django表单设计习惯、最彻底的解决方案，能从根源上避免可变类属性共享带来的问题。

备注：内容来源于stack exchange，提问作者vanderlove