如何让Pydantic Settings在存在环境变量时仍支持非别名字段赋值？

我希望创建一个Pydantic Settings对象，使其环境变量可按需覆盖。但以下示例中，user_3的构造调用失败：

from pydantic import Field
from pydantic_settings import BaseSettings, SettingsConfigDict
import os

class User(BaseSettings):
    model_config = SettingsConfigDict(populate_by_name=True)
    name: str = Field(alias='full_name')  
    age: int

user_1 = User(full_name='John Doe', age=20)  
print(user_1) # >> name='John Doe' age=20
user_2 = User(name='John Doe', age=20)  
print(user_2) # >> name='John Doe' age=20
os.environ["full_name"] = "foo"
user_3 = User(name='John Doe', age=20)  # 报错（信息如下）
print(user_3)

错误信息：

ValidationError: 1 validation error for User
name
  Extra inputs are not permitted [type=extra_forbidden, input_value='John Doe', input_type=str]

请问能否配置该对象，使populate_by_name在环境变量存在时仍能正常工作（即成功构造user_3）？

问题原因 #

当环境变量中存在full_name（对应name字段的别名）时，Pydantic会自动从环境变量加载值到name字段；此时传入name参数，默认配置下会被判定为额外输入字段（因为默认extra='forbid'禁止多余输入），从而触发ValidationError。

解决方法 #

修改model_config，添加extra='ignore'配置（推荐），让Pydantic忽略多余的输入字段，同时保留populate_by_name=True的功能：

from pydantic import Field
from pydantic_settings import BaseSettings, SettingsConfigDict
import os

class User(BaseSettings):
    # 添加extra='ignore'，忽略额外输入
    model_config = SettingsConfigDict(populate_by_name=True, extra='ignore')
    name: str = Field(alias='full_name')  
    age: int

user_1 = User(full_name='John Doe', age=20)  
print(user_1) # >> name='John Doe' age=20
user_2 = User(name='John Doe', age=20)  
print(user_2) # >> name='John Doe' age=20
os.environ["full_name"] = "foo"
user_3 = User(name='John Doe', age=20)  
print(user_3) # >> name='John Doe' age=20

说明 #

• extra='ignore'只会忽略未定义的额外字段，不会影响合法字段的赋值逻辑；传入的name参数优先级仍高于环境变量的full_name，最终会覆盖环境变量的值。
• 如果需要保留额外字段（不推荐），可以将extra设为'allow'，但这样会将多余输入存储到模型的__pydantic_extra__属性中，可能引入不必要的冗余。

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