Pydantic V2.10版本中default_factory调用验证数据的新要求解析

问题背景

在Pydantic V2.10版本中，当使用default_factory来定义字段默认值时，如果设置call_default_factory=True，现在必须同时提供validated_data参数。这一变更导致了一些现有代码出现ValueError: 'validated_data' must be provided if 'call_default_factory' is True的错误。

技术细节分析

Pydantic V2.10引入了一个重要特性：允许default_factory函数访问和依赖其他字段的已验证数据。这意味着默认值工厂函数现在可以基于模型实例中其他已验证字段的值来动态生成默认值。

为了实现这一功能，Pydantic需要在调用default_factory时能够访问到已验证的数据。因此，当开发者显式要求调用默认工厂(call_default_factory=True)时，必须提供validated_data参数。

影响范围

这一变更主要影响以下场景：

1. 直接调用Field.get_default(call_default_factory=True)的代码
2. 使用SQLModel等基于Pydantic构建的框架
3. 自定义模型方法中重置字段默认值的逻辑

解决方案

对于受影响的代码，最简单的修复方法是提供当前模型的已验证数据。可以通过model_dump()方法获取：

def reset_fields(self):
    data = self.model_dump()
    return self.model_copy(
        update={
            field: self.model_fields[field].get_default(
                call_default_factory=True, 
                validated_data=data
            )
            for field in self._reset_fields
        }
    )

版本兼容性

Pydantic团队在发现问题后迅速发布了V2.10.1版本修复此问题。对于暂时无法升级的用户，可以回退到V2.9.2版本作为临时解决方案。

最佳实践建议

1. 当需要调用字段的默认工厂时，始终提供已验证数据
2. 考虑将获取默认值的逻辑封装到模型方法中，避免重复代码
3. 在升级Pydantic版本时，特别注意测试涉及默认值生成的代码路径

总结

这一变更反映了Pydantic框架向更灵活、更强大的默认值生成机制演进的方向。虽然短期内可能导致一些兼容性问题，但从长远来看，它提供了更强大的功能，允许默认值基于模型其他字段动态计算，为复杂的数据验证和初始化场景提供了更好的支持。