UUID在SQLAlchemy/SQLModel中的类型映射挑战
在使用SQLModel（基于Pydantic和SQLAlchemy）定义数据模型时，我们经常会选择UUID作为主键，以利用其全局唯一性。然而，一个常见的问题是，尽管我们在模型中将UUID字段定义为uuid.UUID类型，但在从数据库检索数据时，SQLAlchemy可能会将其映射为Python的str类型，而非我们期望的uuid.UUID对象。这通常会导致类型检查失败，并可能在后续业务逻辑中引发错误。
例如，在以下SQLModel定义中，如果sa_column中使用的数据库特定类型（如SQL Server的UNIQUEIDENTIFIER）没有被SQLAlchemy的方言正确地映射到Python的uuid.UUID类型：
import uuid
from typing import Optional
from sqlmodel import Field, SQLModel
from sqlalchemy import Column, text
# 假设DescriptionConstants是一个常量类
class DescriptionConstants:
GUID = "全局唯一标识符"
NAME = "项目名称"
class GUIDModel(SQLModel):
guid: Optional[uuid.UUID] = Field(
default_factory=uuid.uuid4,
primary_key=True,
description=DescriptionConstants.GUID,
sa_column=Column(
"guid",
# UNIQUEIDENTIFIER, # 这里的数据库特定类型可能导致映射问题
# server_default=text("newsequentialid()"), # 针对SQL Server
),
)
class Project(GUIDModel, table=True):
name: str = Field(max_length=255, description=DescriptionConstants.NAME)当尝试获取project.guid的类型时，可能会得到str而非uuid.UUID，如问题描述所示：
<class 'uuid.UUID'> != <class 'str'> Expected :<class 'str'> Actual :<class 'uuid.UUID'>
这表明SQLAlchemy在从数据库读取数据时，将UUID的底层表示（通常是字符串或二进制）直接作为Python字符串返回，而没有进行uuid.UUID对象的转换。
问题剖析：为何UUID会变为字符串？
造成此问题的主要原因是SQLAlchemy的类型系统在处理特定数据库的UUID类型时，如果没有明确的映射规则或自定义类型处理器，它可能会默认将这些类型的数据作为字符串或字节类型返回。
虽然SQLAlchemy提供了sqlalchemy.dialects.postgresql.UUID类型来处理PostgreSQL的UUID，但对于其他数据库，或者当我们希望使用更通用的方式时，就需要一个自定义的类型转换器来桥接数据库的原始数据类型和Python的uuid.UUID
