Pydantic中Field与Annotated配合使用default_factory的注意事项

在Pydantic V2版本中，Field描述符与Annotated类型的配合使用方式是一个值得开发者关注的技术细节。本文将从实际应用角度分析这一特性的正确使用方式。

背景知识

Pydantic的Field描述符通常用于为模型字段添加额外的验证规则和元数据。在函数参数验证场景中，开发者可以通过两种方式使用Field：

1. 直接作为参数默认值
2. 作为Annotated类型的元数据

文档与实际行为的差异

官方文档曾明确指出，当使用default_factory时，Field不应嵌套在Annotated中。然而在实际测试中发现，Pydantic 2.9.2版本中以下两种写法都能正常工作：

# 方式一：直接作为默认值
@validate_call
def when(dt: datetime = Field(default_factory=datetime.now)):
    return dt

# 方式二：嵌套在Annotated中
@validate_call
def when(dt: Annotated[datetime, Field(default_factory=datetime.now)]):
    return dt

这两种方式都能正确创建datetime实例，与文档描述存在出入。

技术分析

经过深入分析，我们可以得出以下结论：

1. 在较新版本的Pydantic中，Field的default_factory功能在Annotated内部也能正常工作
2. 这种改进可能是框架内部处理逻辑优化的结果
3. 两种方式在功能上是等价的，但直接作为默认值的写法更为直观

最佳实践建议

基于当前版本的行为，我们建议：

1. 对于简单场景，优先使用直接作为默认值的写法，代码更简洁
2. 当需要同时使用多个验证器或元数据时，可以采用Annotated方式
3. 保持对Pydantic版本变更的关注，这类细节行为可能在后续版本中调整

总结

Pydantic框架在不断演进过程中，某些文档描述可能会暂时落后于实际实现。开发者在使用时应当以实际测试结果为准，同时关注框架的更新日志。对于default_factory这类常用功能，两种写法在当前版本下都是可行的选择。