如何为Pydantic模型的可选参数强制非None约束？

你的问题核心在于错误地给带默认值的属性标注了Optional类型——Optional[str]会告诉类型检查器（比如mypy）这个属性可能是str或None，但实际上你的默认值已经确保它永远不会是None，完全不需要用Optional。

正确的实现方式 #

直接将属性的类型标注为目标类型（比如str），同时设置默认值即可。这样既满足「实例化时无需显式传参」的需求，又能让类型检查器明确知道该属性永远不为None。

修改后的代码如下：

#! /usr/bin/env python
from pydantic import BaseModel

class Foobar(BaseModel):
    foo: str = "bazfoo"  # 去掉Optional，直接用str + 默认值

    def getfoo(self) -> str:
        return self.foo

if __name__ == "__main__":
    f = Foobar()
    print(f.getfoo())  # 输出: bazfoo

为什么这能解决问题？ #

• 类型标注str = "bazfoo"明确告诉类型检查器：foo的类型是str，且如果实例化时不传入该参数，会自动使用默认值"bazfoo"，永远不会出现None。
• mypy会认可getfoo方法的返回值类型，不会再抛出「返回值类型不兼容」的错误。

额外说明 #

如果你的场景是允许用户传入None，但模型会自动将其替换为默认值，可以使用Pydantic的Field配合default，同时保持类型标注为非可选：

from pydantic import BaseModel, Field

class Foobar(BaseModel):
    foo: str = Field(default="bazfoo")

这种写法和直接设置默认值效果一致，但如果需要添加额外的字段配置（比如描述、验证规则），Field会更灵活。

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