SQLAlchemy查询Person模型时出现text=uuid运算符不存在错误求助

核心问题 #

错误并非来自你编写的first_name/last_name查询逻辑，而是触发在session.refresh(new_data)执行阶段。从SQL执行日志可看出：SQLAlchemy尝试用UUID类型的值匹配数据库中Person.id字段，但数据库内的id字段实际为TEXT类型，PostgreSQL不存在text = uuid的运算符，因此抛出类型不匹配错误。

解决步骤 #

1. 验证数据库表结构 #

先执行SQL确认Person表id字段的实际类型：

SELECT data_type FROM information_schema.columns WHERE table_name = 'Person' AND column_name = 'id';

若返回结果为text，则需修改字段类型以匹配模型定义。

2. 修改数据库字段类型 #

执行以下SQL将id字段转换为UUID类型：

ALTER TABLE "Person" ALTER COLUMN id TYPE UUID USING id::UUID;

注意：若表中已有数据，需确保现有id值均为合法UUID格式，否则转换会失败。

3. 保持模型定义一致性 #

你的SQLAlchemy模型定义是正确的，无需修改：

class Person(Base):
    __tablename__ = 'Person'

    index = Column(BigInteger, index=True)
    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
    first_name = Column(String(50))
    last_name = Column(String(50))
    occupation = Column(String(50))
    dob = Column(Date)
    country = Column(String(30))

备选方案（无需修改数据库） #

若暂时无法调整数据库结构，可修改模型将id字段指定为TEXT类型，同时在代码中处理UUID字符串转换：

from sqlalchemy.dialects.postgresql import TEXT

class Person(Base):
    __tablename__ = 'Person'

    index = Column(BigInteger, index=True)
    id = Column(TEXT, primary_key=True, default=lambda: str(uuid.uuid4()))
    first_name = Column(String(50))
    last_name = Column(String(50))
    occupation = Column(String(50))
    dob = Column(Date)
    country = Column(String(30))

此方案会将UUID以字符串形式存入数据库，确保查询与refresh操作时类型匹配。

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