Pydantic-Settings 2.6.0嵌套配置加载失败问题求助

针对你遇到的嵌套配置无法加载的问题，核心原因是嵌套字段对应的环境变量命名需要遵循层级规则，同时要确保配置类的继承关系正确。以下是具体解决方案：

1. 配置类的正确写法 #

嵌套的子配置类需继承BaseModel，根配置类继承BaseSettings，并通过model_config指定.env文件路径：

from pydantic import BaseModel
from pydantic_settings import BaseSettings, SettingsConfigDict

# 嵌套的用户配置类
class UserConfig(BaseModel):
    username: str
    password: str

# 根配置类，统一管理所有配置
class AppConfig(BaseSettings):
    app_name: str
    user_config: UserConfig  # 嵌套配置字段

    model_config = SettingsConfigDict(
        env_file=".env.local",
        env_file_encoding="utf-8"
    )

# 加载并验证配置
config = AppConfig()
print(config.app_name)
print(config.user_config.username)

2. .env.local文件的变量命名规则 #

嵌套字段user_config对应的环境变量，需要以大写的字段名+下划线作为前缀，再拼接子字段的大写名称：

# 根配置字段
APP_NAME=MyApplication

# 嵌套的user_config字段
USER_CONFIG_USERNAME=admin_user
USER_CONFIG_PASSWORD=secure_pass_123

3. 额外注意事项 #

• 如果根配置类设置了env_prefix（比如env_prefix="APP_"），那么嵌套字段的环境变量需要加上该前缀，例如APP_USER_CONFIG_USERNAME
• 不要让嵌套类继承BaseSettings，只有根配置类需要继承它，否则会被当作独立的配置加载器处理
• 确认.env.local文件的路径正确，若文件不在当前工作目录，需指定绝对路径或相对路径

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