SQLAlchemy 2.0 ORM中created_date字段自动填充失败问题

问题根源 #

你遇到的核心问题是：模型里配置的server_default=func.now()仅在数据库表结构层面生效，但当前你的数据库表my_table的created_date字段并没有实际带上默认值约束。当ORM插入数据时不传递该字段，数据库因NOT NULL限制直接抛出约束错误。

解决步骤 #

1. 先确认数据库表结构 #

直接通过数据库工具（如pgAdmin、MySQL Workbench或命令行）查看my_table的created_date字段：

• PostgreSQL中需确认字段带有DEFAULT now()约束
• MySQL中需确认字段带有DEFAULT CURRENT_TIMESTAMP约束

如果没有该约束，说明模型配置未同步到数据库，这是问题的核心。

2. 开发环境：同步模型到数据库 #

开发阶段最简单的方式是删除现有表后重新生成：
在初始化代码中执行：

from models import Base, engine  # 确保你已定义engine
Base.metadata.drop_all(engine)
Base.metadata.create_all(engine)

新生成的表会带上server_default对应的数据库默认约束，之后插入数据时，数据库会自动填充created_date值，即使ORM的插入SQL不包含该字段也不会报错。

3. 生产环境：用迁移工具同步表结构 #

生产环境不能直接删表，需用Alembic做迁移：

1. 生成迁移脚本：alembic revision --autogenerate -m "add created_date default"
2. 检查迁移脚本，确认包含添加DEFAULT约束的语句
3. 执行迁移：alembic upgrade head

4. 备选方案：让ORM端自动填充值 #

如果不想依赖数据库默认约束，可在模型中同时添加default=func.now()，让ORM在创建实例时自动生成时间值：

created_date: Mapped[datetime.datetime] = mapped_column(
    DateTime(timezone=True),
    server_default=func.now(),
    default=func.now()  # ORM实例化时自动赋值
)

这样插入SQL会包含created_date字段，同样能避免约束错误。

验证方法 #

重新执行插入操作，开启echo=True后，会出现两种正常情况：

• 插入SQL不包含created_date，但数据库自动填充值（对应数据库端约束生效）
• 插入SQL包含created_date，值为当前时间（对应ORM端赋值生效）

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