Peewee group_by查询结果异常：SQL直接执行与Python调用结果不符

针对你遇到的Peewee分组查询结果与直接执行SQL不一致的问题，结合多租户复用模型的场景，下面是几个排查方向和解决方案：

1. 先用Raw Query验证结果 #

直接在Python中执行你确认正确的SQL语句，快速排除ORM写法的问题：

# 替换为你在MySQL中执行正确的SQL语句
sql = """
SELECT YEAR(created_at) AS year, MONTH(created_at) AS month, SUM(count) AS total 
FROM events 
GROUP BY year, month
"""
with tenant_db.connection_context():
    cursor = tenant_db.execute_sql(sql)
    results = cursor.fetchall()
    print(len(results))  # 对比是否和MySQL执行结果一致

如果此方法返回正确结果，说明你的ORM分组写法存在问题；如果仍返回7条，问题则出在数据库连接或模型绑定环节。

2. 确保模型绑定与上下文切换正确 #

多租户场景下复用模型时，必须保证每次查询前模型绑定到当前租户数据库，且在对应连接上下文内执行：

for tenant_db in tenant_dbs:
    # 强制将模型绑定到当前租户数据库
    Event._meta.database = tenant_db
    # 使用当前数据库的连接上下文
    with tenant_db.connection_context():
        # 对齐正确SQL的分组与聚合逻辑
        query = Event.select(
            fn.YEAR(Event.created_at).alias('year'),
            fn.MONTH(Event.created_at).alias('month'),
            fn.SUM(Event.count).alias('total')
        ).group_by('year', 'month')  # 必须明确指定两个分组字段
        # 打印生成的SQL，与手动执行的SQL对比差异
        print(query.sql())
        results = list(query)
        print(len(results))

注意：不要依赖全局数据库连接，每次切换租户都要重新绑定模型的数据库属性。

3. 排查字段类型与数据异常 #

• 确认所有租户库中events表的created_at字段类型一致（如均为datetime或timestamp），Peewee的日期函数对不同类型的处理可能存在差异。
• 过滤created_at为NULL的记录，避免NULL值被归为同一组导致结果减少：

  query = Event.select(...).where(Event.created_at.is_null(False)).group_by(...)
  

• 若count字段是字符串类型，需强制转换为数值后再聚合：

  fn.SUM(fn.CAST(Event.count, 'INTEGER')).alias('total')
  

4. 对比Peewee生成SQL与手动SQL #

用query.sql()打印ORM生成的SQL语句，与你在MySQL中执行的正确SQL逐行对比，重点检查：

• 分组字段是否完整（比如是否遗漏month字段）
• 聚合函数的参数与写法是否一致
• 是否有Peewee自动添加的额外过滤条件

5. 升级Peewee版本 #

部分旧版本Peewee在分组查询或多租户模型绑定上存在bug，尝试升级到最新稳定版：

pip install --upgrade peewee

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