SQLAlchemy Enum内置校验与自定义validate函数执行顺序冲突如何解决

问题根因 #

你遇到的执行顺序不符合预期有两个核心原因：

• @validates是ORM层的校验钩子，仅在通过ORM会话（session.add/session.query等）操作模型实例时触发，你直接调用Core层的connection.execute执行插入，会完全跳过ORM层的校验逻辑，小写字符串直接进入Enum类型的内置校验环节，因此直接抛出LookupError。
• 即便你使用ORM会话操作，SQLAlchemy的类型处理器执行优先级也高于@validates钩子，Enum的内置校验依然会先执行，你的转大写逻辑还是赶在校验之后运行，依然会报错。

解决方案 #

推荐优先使用「自定义Enum类型」的方案，该方案对Core层和ORM层操作都生效，逻辑统一不会遗漏：

方案1：自定义大小写不敏感的Enum类型 #

重写Enum类型的参数绑定方法，在校验前先完成字符串大写转换：

from sqlalchemy import Column, Integer, Enum as SaEnum
from sqlalchemy.ext.declarative import declarative_base
import enum

Base = declarative_base()

class DummyEnum(enum.Enum):
    NAME_1 = "NAME_1"
    NAME_2 = "NAME_2"

# 自定义Enum类型，自动转换输入字符串为大写
class CaseInsensitiveSaEnum(SaEnum):
    def process_bind_param(self, value, dialect):
        if isinstance(value, str):
            value = value.upper()
        return super().process_bind_param(value, dialect)

class SAEnumVarcharTable(Base):
    __tablename__ = "test_table"
    id = Column(Integer, primary_key=True)
    # 替换为自定义类型，原有参数保持不变
    uut_column = Column(CaseInsensitiveSaEnum(DummyEnum, native_enum=False, validate_strings=True), default=DummyEnum.NAME_1)

修改后你原来的插入语句可以正常执行：

connection.execute(insert(SAEnumVarcharTable), {"uut_column" : "name_1"})

输入的小写字符串会先被转为大写，再进入Enum的内置校验环节，完全符合你的需求。

方案2：基于@validates实现（仅ORM层生效） #

如果仅需要在ORM操作时生效，可以关闭Enum的内置字符串校验，把转换和校验逻辑都放到@validates钩子中：

from sqlalchemy.orm import validates, Session

class SAEnumVarcharTable(Base):
    __tablename__ = "test_table"
    id = Column(Integer, primary_key=True)
    # 关闭Enum内置的字符串校验
    uut_column = Column(SaEnum(DummyEnum, native_enum=False, validate_strings=False), default=DummyEnum.NAME_1)

    @validates('uut_column')
    def validate_uut_column(self, key, uut_value):
        if isinstance(uut_value, str):
            uut_value = uut_value.upper()
            # 手动校验枚举合法性
            if uut_value not in [item.value for item in DummyEnum]:
                raise LookupError(f"{uut_value} 不是合法的DummyEnum值")
        return uut_value

使用时必须通过ORM会话操作才能触发校验：

with Session(engine) as session:
    session.add(SAEnumVarcharTable(uut_column="name_1"))
    session.commit()

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