使用Diesel查询Rust User结构体时类型不匹配错误求助

问题代码与错误信息 #

查询代码 #

let user_result = users
 .filter(username.eq(&login_data.username))
 .select((id, username, password_hash, created_at)) 
 .first::<User>(&mut conn);

错误提示 #

特征约束 (Integer, diesel::sql_types::Text, diesel::sql_types::Text, diesel::sql_types::Nullable<diesel::sql_types::Timestamp>): load_dsl::private::CompatibleType<User, _> 未满足
这是查询返回值与类型预期返回值不匹配导致的
结构体中的字段需要在数量、顺序和类型上与查询返回的字段匹配
建议在结构体 User 上使用 #[derive(Selectable)] 或 #[derive(QueryableByName)] + #[diesel(check_for_backend(_))]，并在查询中使用 .select(User::as_select()) 以获取更清晰的错误信息
以下其他类型实现了特征 load_dsl::private::CompatibleType<U, DB>

User结构体定义 #

#[derive( Selectable, Serialize, Deserialize, Debug)]
pub struct User {
  pub id: i32,
  pub username: String,
  pub password_hash: String,
  pub created_at: Option<NaiveDateTime>, // Nullable field
}

schema.rs表定义 #

diesel::table! {
users (id) {
    id -> Int4,
    username -> Varchar,
    password_hash -> Varchar,
    created_at -> Nullable<Timestamp>,
 }
}

修复方案 #

1. 补充结构体的派生宏 #

给User结构体添加Queryable派生宏，该trait负责将数据库返回的行数据转换为结构体实例：

#[derive(Queryable, Selectable, Serialize, Deserialize, Debug)]
pub struct User {
  pub id: i32,
  pub username: String,
  pub password_hash: String,
  pub created_at: Option<NaiveDateTime>, // Nullable field
}

2. 修改查询的select语句 #

将手动指定字段的select((id, username, password_hash, created_at))替换为Selectable提供的User::as_select()，让Diesel自动根据结构体字段生成匹配的查询选择项，避免手动指定可能出现的类型/映射不匹配：

let user_result = users
 .filter(username.eq(&login_data.username))
 .select(User::as_select()) 
 .first::<User>(&mut conn);

原理说明 #

手动指定返回字段时，即使字段数量、顺序看起来一致，Diesel的类型系统也无法直接将返回的元组类型与User结构体关联。User::as_select()会根据结构体的字段定义，自动生成与数据库表字段对应的查询选择逻辑，同时Queryable trait确保数据库返回的类型能正确转换为结构体的字段类型，两者配合即可解决类型不匹配的问题。

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