如何在Uvicorn运行的FastAPI/Pydantic模型中使用动态枚举？

我有一个定义了Pydantic模型的FastAPI应用，部分模型字段仅允许使用从数据库加载、运行时创建的枚举值。当前配置在调试或通过Python命令行运行时正常，但使用uvicorn main:app启动时，虽能成功加载枚举，但模型似乎先于枚举加载，导致应用启动失败并抛出ImportError。

我尝试过不使用导入语句，而是从models/enums.py第139行声明的enum_definitions单例中获取枚举定义，即：

Enum1 = enum_definitions.get_enum_definition("Enum1")

这触发了models/enums.py第104行的异常。我还尝试过在main.py实例化FastAPI对象前、以及models/model1.py声明模型类前加载枚举，但所有这些方法都导致模型无法识别枚举。

请问如何让模型正常使用这些动态枚举？

1. 延迟模型导入到枚举加载完成后 #

在main.py中先执行枚举加载逻辑，再导入依赖枚举的模型和路由：

from models.enums import enum_definitions

# 优先加载所有动态枚举
enum_definitions.load_all_enums()

# 枚举加载完成后再导入模型与路由
from models.model1 import Model1
from routers import router

app = FastAPI()
app.include_router(router)

同时确保模型文件中仅在枚举加载完成后引用enum_definitions中的枚举，避免在模块顶层直接依赖未初始化的枚举对象。

2. 使用Pydantic动态验证替代静态枚举绑定 #

放弃在模型定义时直接绑定静态枚举，改用BeforeValidator实现动态校验，彻底避开加载顺序冲突：

from pydantic import BaseModel, BeforeValidator
from models.enums import enum_definitions

def validate_enum1(value: str) -> str:
    enum1 = enum_definitions.get_enum_definition("Enum1")
    if value not in enum1.__members__:
        raise ValueError(f"Enum1有效值为：{list(enum1.__members__.keys())}")
    return value

class Model1(BaseModel):
    enum_field: str = BeforeValidator(validate_enum1)

这种方式仅在实际验证请求数据时才获取枚举定义，无需在模型初始化阶段依赖枚举。

3. 动态生成Pydantic模型类 #

等枚举加载完成后，通过create_model动态创建包含枚举字段的模型：

from pydantic import create_model
from models.enums import enum_definitions

# 加载枚举
enum_definitions.load_all_enums()
Enum1 = enum_definitions.get_enum_definition("Enum1")

# 动态生成模型
Model1 = create_model(
    "Model1",
    enum_field=(Enum1, ...)
)

后续路由中直接使用该动态生成的模型，确保模型创建发生在枚举加载之后。

4. 自定义启动脚本控制加载顺序 #

创建start.py作为启动入口，先完成枚举加载再启动Uvicorn：

# start.py
from models.enums import enum_definitions

# 加载所有动态枚举
enum_definitions.load_all_enums()

# 导入并启动应用
import uvicorn
from main import app

if __name__ == "__main__":
    uvicorn.run("main:app", host="0.0.0.0", port=8000, reload=True)

使用python start.py命令启动应用，替代直接调用uvicorn main:app，确保枚举优先于所有依赖模块加载。

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