FastAPI/SQLModel中X | None替代Optional字符串类型注解报错问题

当你在Python 3.10+环境下用X | None替换Optional[X]时，遇到字符串类型注解（如"User"）无法与None通过|操作符组合的报错，可通过以下几种方式解决：

方法1：使用字符串形式的联合类型注解 #

把整个联合类型写成字符串，避免运行时执行|操作触发错误：

class OAuthAccount(SQLModel):
    user: "User | None" = None

这种写法下，mypy、pyright等类型检查器能正常解析字符串注解，同时Python运行时不会抛出TypeError。

方法2：提前声明或导入关联类 #

如果User类在当前文件中定义于OAuthAccount之后，可将User的定义移至OAuthAccount之前；若为跨文件引用，直接导入User类，就能直接使用User | None而无需字符串注解：

from .models import User

class OAuthAccount(SQLModel):
    user: User | None = None

若为同文件内类的互相引用，可先做前置声明：

class User(SQLModel):
    pass

class OAuthAccount(SQLModel):
    user: User | None = None

# 后续补充User类的具体字段定义

方法3：保留Optional配合字符串注解 #

如果暂时不想调整注解形式，也可以继续使用Optional["User"]——Python 3.10+仍支持该写法，类型检查器能正确识别，不会影响类型提示和校验逻辑。

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