Peewee模型中避免可变默认值的陷阱

在Python ORM框架Peewee的使用过程中，模型字段的默认值设置是一个需要特别注意的环节。最近有开发者反馈在使用BinaryJSONField时遇到了默认值被意外修改的问题，这实际上涉及到了Python中一个经典的可变默认值陷阱。

问题本质

当我们在Peewee模型字段中直接使用可变对象（如字典、列表等）作为默认值时，这个默认值会在模型类定义时就被创建并成为类属性的一部分。由于Python中类属性是共享的，所有实例都会访问同一个默认值对象。这意味着如果某个实例修改了这个默认值，所有后续创建的实例都会受到影响。

问题复现

以BinaryJSONField为例，如果直接这样定义：

cooldowns = pw_ex.BinaryJSONField(default={
    "bonus": 0,
    "safe": 0,
    # 其他字段...
})

这个字典对象会在类定义时创建，并成为类属性的一部分。当某个实例修改了这个字典后，所有新创建的实例都会继承被修改后的值，而不是最初定义的默认值。

解决方案

Peewee官方推荐的做法是使用可调用对象（如lambda函数）来延迟默认值的创建：

cooldowns = pw_ex.BinaryJSONField(default=lambda: {
    "bonus": 0,
    "safe": 0,
    # 其他字段...
})

这种写法确保了每次创建新实例时都会调用lambda函数生成一个新的字典对象，从而避免了实例间共享同一个默认值的问题。

更深入的理解

这个问题的根源在于Python的类属性初始化机制。类属性在类定义时就会被求值并存储，而实例属性是在实例化时创建的。对于不可变对象（如整数、字符串等）这不是问题，但对于可变对象就会导致意外的共享状态。

Peewee的这种设计实际上给了开发者更大的灵活性，允许我们根据需要决定是共享默认值还是每次都创建新对象。对于需要独立副本的场景，使用可调用对象是最佳实践。

最佳实践建议

1. 对于所有可变类型的默认值，都应该使用可调用对象
2. 简单的不可变类型（如整数、字符串）可以直接作为默认值
3. 复杂的不可变类型（如元组）也可以直接使用
4. 对于需要动态生成的默认值（如当前时间），必须使用可调用对象

通过遵循这些原则，可以避免许多潜在的共享状态问题，确保模型的每个实例都有自己独立的默认值副本。