PyCharm使用**kwargs实例化Pydantic模型提示extra fields not permitted问题

定义如下继承自pydantic.BaseModel的类：

class OptimizerConfig(pydantic.BaseModel):
   
    learning_rate: StrictFloat
    learning_rate_decay: Optional[StrictFloat]

    class Config:
        arbitrary_types_allowed = True
        extra = Extra.forbid

使用字典解包方式实例化：

params = {"learning_rate": 0.1, "learning_rate_decay": 0.1}
optimizer_config = OptimizerConfig(**params)

代码运行逻辑完全符合预期：传入额外参数、参数类型不符合要求（例如传入learning_rate=1）时，类会正常抛出pydantic.error.wrappers.ValidationError。但这种字典解包传参的写法会触发PyCharm警告：

null extra fields not permitted

改用直接传入关键字参数的写法实例化时，不会出现该提示：

OptimizerConfig(learning_rate=0.1, learning_rate_decay=0.1)

该警告不影响代码实际运行，不会触发运行时异常。

这是PyCharm内置Pydantic静态检查功能的已知误报bug，和代码本身逻辑无关。
当Pydantic模型配置了extra = Extra.forbid时，PyCharm的静态检查逻辑无法正确识别字典解包传入的键值是否属于模型合法字段，会误判存在非法额外字段，因此弹出警告。直接传入关键字参数时，检查逻辑可以逐一枚举入参做匹配校验，因此不会出现误报。

可以根据自身需求选择以下方案消除警告：

• 在触发警告的代码行上方添加注释# noinspection PyArgumentList，抑制该行的参数检查类警告
• 将PyCharm升级至2023.2及以上版本，该版本已修复Pydantic v1场景下的大部分静态检查误报问题
• 迁移使用Pydantic v2，搭配最新版PyCharm的官方Pydantic支持插件，这类解包传参的误报基本不会再出现

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