如何在运行时动态修改Pydantic模型的alias_generator配置？

问题分析 #

你尝试直接修改实例的Config类属性来切换alias_generator，但这种方式存在两个核心问题：

1. 修改类属性会全局影响所有实例，无法实现单实例级别的配置隔离；
2. 子模型的Config在定义时已继承父类配置，后续修改父类Config不会同步到已定义的子模型。

以下提供两种适配FastAPI场景的可行解决方案：

方案一：动态生成带指定配置的模型类（推荐用于Pydantic v2） #

通过工厂函数递归创建继承原模型的子类，替换alias_generator，确保嵌套子模型同步应用目标配置：

步骤1：定义基础模型与转换函数 #

from pydantic import BaseModel, ConfigDict
from pydantic.alias_generators import to_camel, to_pascal, to_snake

# 定义无默认Config的基础模型
class ParentModel(BaseModel):
    pass

class ChildModel(ParentModel):
    first_name: str

class ChildModel2(ParentModel):
    data: ChildModel

步骤2：编写模型工厂函数 #

def create_configured_model(base_model, alias_generator):
    # 创建继承原模型的子类，覆盖model_config
    class ConfiguredModel(base_model):
        model_config = ConfigDict(
            alias_generator=alias_generator,
            allow_population_by_field_name=True
        )
    
    # 递归处理嵌套模型，确保子字段也应用新配置
    for field_name, field in ConfiguredModel.model_fields.items():
        annotation = field.annotation
        # 判断是否为自定义BaseModel子类
        if hasattr(annotation, "__bases__") and BaseModel in annotation.__bases__:
            ConfiguredModel.model_fields[field_name].annotation = create_configured_model(annotation, alias_generator)
    
    return ConfiguredModel

步骤3：使用示例 #

# 生成不同命名格式的模型类
CamelChildModel2 = create_configured_model(ChildModel2, to_camel)
PascalChildModel2 = create_configured_model(ChildModel2, to_pascal)

# 帕斯卡格式实例化与序列化
pascal_instance = PascalChildModel2(data=ChildModel(first_name="test"))
print(pascal_instance.model_dump(by_alias=True))
# 输出: {'Data': {'FirstName': 'test'}}

# 驼峰格式实例化与序列化
camel_instance = CamelChildModel2(data=ChildModel(first_name="test"))
print(camel_instance.model_dump(by_alias=True))
# 输出: {'data': {'firstName': 'test'}}

FastAPI集成 #

根据请求参数动态选择模型类返回：

from fastapi import FastAPI, Query

app = FastAPI()

@app.get("/data")
def get_data(format: str = Query("camel")):
    raw_data = ChildModel2(data=ChildModel(first_name="FastAPI Test"))
    # 根据格式选择对应模型
    model_cls = {
        "camel": CamelChildModel2,
        "pascal": PascalChildModel2,
        "snake": create_configured_model(ChildModel2, to_snake)
    }[format]
    # 转换为对应配置的模型实例并返回
    return model_cls(**raw_data.model_dump())

方案二：动态序列化（无需修改模型Config） #

直接在FastAPI响应阶段，递归遍历模型数据并应用指定的命名转换，无需修改模型类本身：

实现代码 #

from fastapi import FastAPI, Query
from fastapi.responses import JSONResponse

app = FastAPI()

def serialize_with_alias(model, alias_generator):
    """递归序列化模型，应用指定的别名生成器"""
    if isinstance(model, BaseModel):
        result = {}
        for field_name, field in model.model_fields.items():
            value = getattr(model, field_name)
            alias = alias_generator(field_name)
            result[alias] = serialize_with_alias(value, alias_generator)
        return result
    elif isinstance(model, list):
        return [serialize_with_alias(item, alias_generator) for item in model]
    elif isinstance(model, dict):
        return {k: serialize_with_alias(v, alias_generator) for k, v in model.items()}
    else:
        return model

@app.get("/dynamic-data")
def get_dynamic_data(format: str = Query("camel")):
    data = ChildModel2(data=ChildModel(first_name="Dynamic Test"))
    # 根据格式选择别名生成器
    alias_gen = {
        "camel": to_camel,
        "pascal": to_pascal,
        "snake": to_snake
    }[format]
    # 动态序列化后返回JSON
    serialized_data = serialize_with_alias(data, alias_gen)
    return JSONResponse(content=serialized_data)

注意事项 #

• 若使用Pydantic v1，需将model_config替换为Config类，model_fields替换为__fields__，model_dump替换为dict()；
• 方案一更适合需要复用模型配置的场景，方案二更适合轻量动态切换的场景。

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