如何在SQLAlchemy中用func.strftime()筛选SQLite当月历史已关注事件

需要查询当前用户已关注的、发生在当月（不限年份，只要月份为当前系统月）的已结束事件。数据库中存在4月（当前月）的相关事件，但查询未返回结果，排查后确定问题出在使用func.strftime()筛选Event.event_date的逻辑上。

当前查询代码：

monthly_events = current_user.followed_events().filter(Event.event_date < datetime.today().date()).filter(func.strftime('%m', Event.event_date == datetime.today().strftime('%m'))).order_by(Event.timestamp.desc())

拆分验证后确认：

• current_user.followed_events().filter(Event.event_date < datetime.today().date())可正确获取所有已结束事件
• 排序逻辑正常
• 仅月份筛选的filter(func.strftime('%m', Event.event_date == datetime.today().strftime('%m')))存在错误

环境信息：

• 使用Flask框架，SQLAlchemy作为ORM
• 数据库当前为SQLite，后续将切换至PostgreSQL
• Event.event_date字段为db.DateTime类型，默认值为datetime.utcnow
• 已导入from sqlalchemy import func和from datetime import datetime

1. 修正func.strftime()的参数错误 #

原代码错误地将比较逻辑嵌套进了func.strftime()的参数中，正确逻辑是先提取event_date的月份，再与当前月份字符串做比较：

SQLite兼容修正代码：

current_month = datetime.utcnow().strftime('%m')  # 用UTC时间避免时区偏差
monthly_events = current_user.followed_events()\
    .filter(Event.event_date < datetime.utcnow().date())  # 统一用UTC时间判断事件已结束
    .filter(func.strftime('%m', Event.event_date) == current_month)\
    .order_by(Event.timestamp.desc())

2. 跨数据库兼容写法（适配SQLite和PostgreSQL） #

由于后续要切换到PostgreSQL，func.strftime()无法在PostgreSQL中正常工作（PostgreSQL使用EXTRACT处理日期字段提取）。推荐使用SQLAlchemy的func.extract()，它会自动适配不同数据库的语法：

current_month = datetime.utcnow().month  # 直接用数字月份，无需转字符串
monthly_events = current_user.followed_events()\
    .filter(Event.event_date < datetime.utcnow().date())\
    .filter(func.extract('month', Event.event_date) == current_month)\
    .order_by(Event.timestamp.desc())

关键注意点 #

• 时区一致性：event_date默认用datetime.utcnow()存储，判断时也应使用datetime.utcnow()而非datetime.today()（后者是本地时间），避免因时区差异导致月份判断错误。
• 函数参数格式：func.strftime()的正确格式为func.strftime(格式字符串, 日期字段)，原代码的嵌套写法完全不符合语法要求。

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