SQLAlchemy声明式表中Getter/Setter格式转换异常排查

你的问题出在两个核心点：表名定义错误，以及用Python@property实现字段转换不符合SQLAlchemy的ORM工作逻辑——正确的做法是使用SQLAlchemy内置的TypeDecorator来实现字段的双向格式转换。

问题分析 #

1. 表名定义错误：你用__table__ = "test_table"是错误的，SQLAlchemy中指定表名应该用__tablename__，__table__需要赋值为Table对象而非字符串。
2. @property的局限性：Python属性与SQLAlchemy映射列分离，会导致两个关键问题：
   • 查询时无法直接用start_time作为条件（因为它不是SQLAlchemy的列对象）；
   • ORM在处理对象状态时，可能意外触发getter的反向转换，导致存储的值被错误覆盖。

正确解决方案：使用TypeDecorator自定义类型 #

TypeDecorator是SQLAlchemy官方推荐的字段格式转换方案，它会在数据库绑定（写入）和结果返回（读取）时自动处理格式转换，完全适配ORM的工作流程。

完整代码示例 #

from sqlalchemy.orm import DeclarativeBase, mapped_column, Mapped
from sqlalchemy import Integer, String
from sqlalchemy.types import TypeDecorator
import datetime

class Base(DeclarativeBase):
    pass

class CustomDateTimeType(TypeDecorator):
    # 底层存储类型为字符串，长度匹配数据库格式
    impl = String(23)

    def process_bind_param(self, value, dialect):
        # 赋值时：用户格式 -> 数据库格式
        if value is None:
            return None
        return datetime.strptime(value, "%Y%m%d-%H%M%S").strftime("%Y-%m-%d %H:%M:%S")

    def process_result_value(self, value, dialect):
        # 查询时：数据库格式 -> 用户格式
        if value is None:
            return None
        return datetime.strptime(value, "%Y-%m-%d %H:%M:%S").strftime("%Y%m%d-%H%M%S")

class MyTable(Base):
    __tablename__ = "test_table"  # 修正表名定义方式

    # SQLAlchemy要求映射表必须定义主键
    id: Mapped[int] = mapped_column(Integer, primary_key=True)
    start_time: Mapped[str | None] = mapped_column(CustomDateTimeType, nullable=True, index=True)

使用方式 #

# 插入数据：直接传入用户格式的时间
obj = MyTable(start_time="20230301-120000")
session.add(obj)
session.commit()
# 数据库中存储的是 "2023-03-01 12:00:00"

# 查询数据：自动返回用户格式的时间
obj = session.query(MyTable).first()
print(obj.start_time)  # 输出 "20230301-120000"

# 查询条件也可以直接用用户格式
target_obj = session.query(MyTable).filter(MyTable.start_time == "20230301-120000").first()

原代码出错原因 #

你原来的代码中，赋值start_time后_start_time确实被转换成了数据库格式，但如果后续ORM内部检查对象状态或你主动访问start_time属性，getter会返回反向转换后的用户格式；若此时误将该值重新赋值给start_time，会触发setter再次转换，导致_start_time变成错误的格式（相当于把用户格式转成数据库格式后，又转成用户格式再转一次数据库格式，结果完全不符合预期）。

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