类嵌套定义Pydantic模型报错：Unresolved reference 'Student'求解

你想用嵌套类分类管理Pydantic模型是完全可行的，出现Unresolved reference 'Student'错误，是因为同一个外层类的内部类之间直接引用时，Python解释器无法识别未限定作用域的Student类。以下是两种解决方法：

方法1：通过外层类限定引用 #

在外层类Students内部的StudentRequest里，直接用Students.Student指定类型。如果你的Python版本低于3.7，记得加上from __future__ import annotations来支持前向引用：

from typing import List, Union
from pydantic import BaseModel
from __future__ import annotations  # Python<3.7需要，3.7+可省略

class Students:
    class Student(BaseModel):
        StudentName: str
        StudentAge: int

    class StudentRequest(BaseModel):
        Class: int
        UUID: str
        Students: Union[List[Students.Student], None]

方法2：使用字符串形式的前向引用 #

把Student用引号包裹成字符串，让Pydantic在模型初始化阶段再解析这个类型，这种方式不需要额外导入：

from typing import List, Union
from pydantic import BaseModel

class Students:
    class Student(BaseModel):
        StudentName: str
        StudentAge: int

    class StudentRequest(BaseModel):
        Class: int
        UUID: str
        Students: Union[List["Student"], None]

本质上是因为定义StudentRequest属性时，Student作为内部类还没被当前作用域直接注册，通过上述两种方式就能让Pydantic正确识别类型，实现用嵌套类分类管理模型的需求。

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