使用Peewee遍历PostgreSQL关联查询结果时遇属性错误

问题原因 #

你的Conversation模型中定义了外键字段contact_id，但访问关联对象时报错找不到contact属性，主要有两个核心原因：

1. 模型定义顺序问题：如果Conversation在Contact之前定义，直接用ForeignKeyField(Contact)会导致Peewee无法正确解析关联模型——此时Contact还未被定义，无法建立关联映射。
2. 查询字段选择错误：你之前的关联查询仅选择了Contact的字段，未包含Conversation自身的字段，导致遍历得到的对象缺失外键关联的必要信息，无法触发关联属性的加载。

修复步骤 #

1. 修正外键定义（针对模型顺序问题） #

如果Conversation的定义早于Contact，需要将外键的模型引用改为字符串形式，让Peewee延迟解析：

class Conversation(peewee.Model):
    id = peewee.AutoField(unique=True, index=True)
    creation_date = peewee.DateTimeField(default=datetime.now)
    # 用字符串引用未定义的Contact模型，避免解析顺序问题
    contact_id = peewee.ForeignKeyField('Contact', backref='conversations')
    launch_id = peewee.ForeignKeyField('Launch', backref='conversations')
    request_data = peewee.TextField(null=True)
    status = peewee.TextField(null=True)

注：backref建议用复数形式（如conversations），符合一个Contact对应多个Conversation的逻辑，不影响功能但更规范。

2. 编写正确的关联查询 #

查询时需要同时选择Conversation和Contact的字段，确保关联属性能正常访问：

# 方式1：关联查询并预加载关联对象，避免N+1查询
query = Conversation.select(Conversation, Contact).join(Contact).where(Conversation.launch_id == str(launch_id))
for conversation in query:
    print(conversation.contact.id)

如果数据量较小，允许懒加载（会产生N+1查询，不推荐大数据场景），只需确保外键定义正确，直接访问即可：

for conversation in Conversation.select().where(Conversation.launch_id == str(launch_id)):
    # Peewee会自动执行SQL获取关联的Contact对象
    print(conversation.contact.id)

额外说明 #

你之前的Conversation.select(Contact).join(Contact)仅选择了Contact的字段，遍历得到的conversation对象实际上只包含Contact的数据，缺失Conversation自身的外键信息，因此无法访问conversation.contact属性。

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