在 SQLAlchemy 中为多个 DateTime 字段（如 inserted_at 和 modified_at）同时设置 default=datetime.utcnow 会导致毫秒级时间偏差，根本原因是 Python 端函数被重复调用；应统一使用数据库服务端默认值（server_default 和 onupdate）确保原子性与一致性。
在 sqlalchemy 中为多个 datetime 字段（如 `inserted_at` 和 `modified_at`）同时设置 `default=datetime.utcnow` 会导致毫秒级时间偏差，根本原因是 python 端函数被重复调用；应统一使用数据库服务端默认值（`server_default` 和 `onupdate`）确保原子性与一致性。
当使用 SQLAlchemy ORM 插入新记录时，若对多个时间戳列（例如创建时间和更新时间）均配置 default=datetime.utcnow，看似简洁，实则埋下一致性隐患：Python 解释器会分别、独立地执行两次 datetime.utcnow() 调用，两次调用之间存在微小时间差（通常为几毫秒），导致 inserted_at 和 modified_at 在同一行中出现不一致——这违背了“插入即初始化”的语义预期，也与纯 SQL 插入（如 INSERT INTO ... VALUES (...)）中数据库原生 NOW() 函数返回完全相同时间戳的行为不符。
根本解法是将时间生成逻辑完全移交至数据库服务端，避免 Python 层参与时间计算。具体做法如下：
- ✅ 对 inserted_at：仅保留 server_default=func.now()，移除 default 参数；
- ✅ 对 modified_at：保留 server_default=func.now()（确保 INSERT 时有初始值），并添加 onupdate=func.now()（确保 UPDATE 时自动刷新）；
- ❌ 移除所有 default=datetime.utcnow 或 default=lambda: datetime.utcnow() 类型的 Python 端默认值。
修正后的模型定义示例如下：
from sqlalchemy import Column, String, Integer, DateTime, func
from sqlalchemy.ext.declarative import declarative_base
Base = declarative_base()
class RenterLead(Base):
__tablename__ = "renter_leads"
uuid = Column(String, nullable=False, primary_key=True)
owner = Column(Integer, nullable=False) # 简化外键示意
name = Column(String)
email = Column(String)
phone_number = Column(String)
inserted_at = Column(
DateTime,
nullable=False,
server_default=func.now() # ✅ 仅服务端默认，INSERT 时由 DB 生成统一时间
)
modified_at = Column(
DateTime,
nullable=False,
server_default=func.now(), # ✅ INSERT 时同上
onupdate=func.now() # ✅ UPDATE 时自动触发更新
)关键说明：server_default 仅在通过 ORM 执行 session.add() + session.commit() 或直接执行 INSERT 语句时生效；它不影响内存中未提交对象的属性值（即 obj.inserted_at 初始为 None）。若业务逻辑需在提交前读取该时间（如日志、校验），可配合 @hybrid_property 或事件监听器（@event.listens_for(RenterLead, 'before_insert')）补充客户端回填，但绝大多数场景无需此操作——因为真实可信的时间戳应以数据库落盘时刻为准。
此外，请注意不同数据库对 func.now() 的实现略有差异：
- PostgreSQL：推荐使用 func.now() 或更精确的 func.clock_timestamp()（事务内稳定）；
- MySQL：func.now() 即当前语句执行时间，满足一致性要求；
- SQLite：func.current_timestamp() 是标准写法。
最后强调：永远不要混用 default（Python 端）和 server_default（SQL 端）于同一时间字段，否则可能引发不可预测的覆盖行为或警告。保持时间来源单一、权威，是构建可靠审计字段的基础。
