如何在diesel::sql_query中使用UUID？编译报错trait bound不满足

问题描述 #

执行原生SQL无参数时编译正常，但添加.bind::<Uuid, _>(session_id)后出现编译错误：

the trait bound uuid::Uuid: ToSql<uuid::Uuid, _> is not satisfied

核心原因 #

报错本质是类型混淆：你把Rust的uuid::Uuid类型作为了ToSql trait的第一个类型参数，但ToSql要求第一个参数是Diesel定义的SQL类型（对应数据库中的字段类型），而非Rust的Uuid类型。

解决步骤 #

1. 确保Diesel启用Uuid支持 #

在Cargo.toml中为diesel添加uuid feature，同时包含你使用的数据库feature（以postgres为例）：

[dependencies]
diesel = { version = "2.0", features = ["postgres", "uuid", "chrono"] }
uuid = { version = "1.0", features = ["v4"] }

2. 正确导入类型 #

在代码中明确区分Diesel的SQL类型和Rust的Uuid类型：

use diesel::sql_types::Uuid; // Diesel定义的SQL类型，对应数据库中的UUID字段
use uuid::Uuid as UuidType; // Rust的Uuid类型，避免和上面的SQL类型重名

3. 修正bind参数的类型指定 #

绑定参数时，第一个类型参数传入Diesel的sql_types::Uuid，第二个参数传入Rust的Uuid实例：

sql_query("SELECT * FROM sessions WHERE id = $1")
    .bind::<Uuid, _>(session_id) // 第一个类型是Diesel的SQL类型，第二个是Rust的Uuid
    .load::<Session>(&conn)?;

完整示例代码 #

use diesel::{sql_query, sql_types::Uuid, RunQueryDsl, QueryResult};
use uuid::Uuid as UuidType;
use diesel::PgConnection;

#[derive(Queryable)]
struct Session {
    id: UuidType,
    user_id: UuidType,
    expires_at: chrono::NaiveDateTime,
}

fn fetch_session(conn: &PgConnection, session_id: UuidType) -> QueryResult<Session> {
    sql_query("SELECT id, user_id, expires_at FROM sessions WHERE id = $1")
        .bind::<Uuid, _>(session_id)
        .get_result(conn)
}

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