使用Diesel向SQLite表插入数据时遇模糊trait bound错误

在使用Diesel ORM向SQLite插入数据时，调用.get_result(&mut connection)出现大量Trait约束相关错误，核心提示为ReturningClause未实现QueryFragment等trait。相关代码如下：

插入函数代码：

use diesel::prelude::*;
use crate::models::Book;
use crate::schema::books;
use crate::db;


pub fn create_book(book: &Book) -> Book {
    let mut connection: SqliteConnection = db::establish_connection();
    diesel::insert_into(books::table)
        .values(book)
        .get_result(&mut connection)
        .expect("Error saving new post")
}

Book结构体定义：

use diesel::prelude::*;
use serde::{Serialize, Deserialize};
use crate::schema::books;

#[derive(Queryable, Serialize, Deserialize, Insertable)]
#[diesel(table_name = books)]
pub struct Book {
    pub book_id: i32,
    pub title: String,
    pub author: String,
    pub creation_date: String,
    pub publishing_house: String,
    pub release_date: String,
    pub cover_image: String
}

错误原因分析 #

1. SQLite原生不支持RETURNING子句：Diesel的get_result方法依赖数据库返回插入后的完整行数据，但SQLite（默认配置下）不支持RETURNING语法，这是触发ReturningClause相关Trait错误的核心原因。
2. 结构体职责冲突：同一个Book结构体同时实现Queryable和Insertable，但插入时不需要指定自增主键book_id，字段冗余会导致Diesel推导插入逻辑时出现冲突。

解决思路与步骤 #

1. 拆分结构体，分离查询与插入模型 #

将查询用模型和插入用模型分开，避免字段职责冲突：

use diesel::prelude::*;
use serde::{Serialize, Deserialize};
use crate::schema::books;

// 用于查询的模型，包含所有字段（包括自增主键）
#[derive(Queryable, Serialize, Deserialize)]
#[diesel(table_name = books)]
pub struct Book {
    pub book_id: i32,
    pub title: String,
    pub author: String,
    pub creation_date: String,
    pub publishing_house: String,
    pub release_date: String,
    pub cover_image: String
}

// 用于插入的模型，剔除自增主键book_id
#[derive(Insertable)]
#[diesel(table_name = books)]
pub struct NewBook {
    pub title: String,
    pub author: String,
    pub creation_date: String,
    pub publishing_house: String,
    pub release_date: String,
    pub cover_image: String
}

2. 修改插入函数适配SQLite特性 #

由于SQLite不支持get_result，改用execute执行插入，再通过SQLite的last_insert_rowid()获取自增ID并查询新增数据：

use diesel::prelude::*;
use crate::models::{Book, NewBook};
use crate::schema::books;
use crate::db;

pub fn create_book(new_book: &NewBook) -> Book {
    let mut connection = db::establish_connection();
    
    // 执行插入操作
    diesel::insert_into(books::table)
        .values(new_book)
        .execute(&mut connection)
        .expect("Failed to insert book");
    
    // 通过自增ID查询刚插入的书籍
    books::table
        .filter(books::book_id.eq(connection.last_insert_rowid() as i32))
        .first(&mut connection)
        .expect("Failed to retrieve inserted book")
}

备选方案（不推荐）：启用SQLite RETURNING扩展 #

若坚持使用get_result，需满足以下条件：

• SQLite版本≥3.35.0
• 加载enable_returning扩展
• 在Diesel配置中启用对应特性
  但该方案兼容性较差，不如拆分模型+手动查询的方式稳定可靠。

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