Peewee关联查询触发特定筛选条件时未返回全部选中字段求助

核心原因 #

• 查询对象复用逻辑错误：你在计算total_characters时直接调用了原查询的.count()方法，旧版本Peewee的.count()会修改原查询的SELECT子句，将你最初声明的Character全字段、聚合字段、CharactersOwnership.discord_user_id替换为计数用的COUNT(1)，清空原有返回字段配置。当没有走affiliation分支时，查询关联表少，Peewee的自动字段补全逻辑可正常生效；一旦多关联了两层表，自动补全逻辑失效，就会出现字段缺失。
• 多层关联导致结果映射混乱：当你先后join了CharacterAffiliation、Affiliation、CharactersOwnership三个关联表之后，Peewee默认会按关联顺序优先解析靠前的表字段，如果你没有显式声明需要返回的字段，Character的字段会被后续关联表字段覆盖或遗漏。

修复方案 #

1. 计数时使用独立的克隆查询，避免修改原查询配置：
   将total_characters = query.count()修改为：

total_characters = query.clone().count()

2. 完成所有查询条件、关联配置后，重新显式声明返回字段：
   在你完成join、where、group by的配置后，追加SELECT声明：

query = query.select(Character, fn.Count(Character.id).alias('count'), CharactersOwnership.discord_user_id)

3. 可选优化：如果不需要返回Character的全部字段，可以只SELECT你实际用到的字段，同时把所有非聚合字段加入GROUP BY子句，进一步降低映射错误概率。

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