使用Sea-ORM多表关联查询仅返回主表数据的问题排查

API 探路者

2026-7-24

问题原因与解决方案

这不是Sea-ORM的Bug，是预期行为——你用的cecc::Model结构体和cecc单表强绑定，只包含该表的字段定义，Sea-ORM映射查询结果时，只会填充Model中存在的字段，额外通过column_as指定的关联表字段会被直接忽略。

解决方法：自定义结果结构体

你需要定义一个包含cecc表字段+所需cecc_instance字段的结构体，让Sea-ORM知道如何映射所有查询结果：

定义组合结构体
用Sea-ORM的DeriveFromQueryResult宏专门处理自定义查询结果映射：

use sea_orm::{FromQueryResult, DeriveFromQueryResult};
use chrono::DateTime;

#[derive(Debug, Clone, PartialEq, DeriveFromQueryResult)]
struct CeccWithInstance {
    // cecc表的字段，和原Model保持一致
    id: i32,
    name: String,
    // ... 其他cecc表字段
    
    // cecc_instance表的字段，对应你column_as指定的别名
    #[sea_orm(column_name = "instance_status")]
    instance_status: String,
    #[sea_orm(column_name = "instance_created_at")]
    instance_created_at: DateTime<chrono::Utc>,
}

调整查询代码
明确指定所有需要的字段，并用into_model将结果映射到自定义结构体：

let page_data = cecc::Entity::find()
    .inner_join(cecc_instance::Entity, cecc_instance::Column::CeccId.eq(cecc::Column::Id))
    // 明确选择cecc表字段 + 关联表字段并指定别名
    .column(cecc::Column::Id)
    .column(cecc::Column::Name)
    .column_as(cecc_instance::Column::Status, "instance_status")
    .column_as(cecc_instance::Column::CreatedAt, "instance_created_at")
    .filter(cecc::Column::Id.gt(10)) // 你的过滤条件
    .into_model::<CeccWithInstance>()
    .fetch_page(db, 1, 20) // 页码 + 每页数量
    .await?;