Rust Web 全栈开发（六）：在 Web 项目中使用 MySQL 数据库

最新推荐文章于 2025-07-13 01:01:21 发布
最新推荐文章于 2025-07-13 01:01:21 发布
阅读量814 收藏 16
点赞数 9
CC 4.0 BY-SA版权
分类专栏： Rust 文章标签： 数据库 Rust
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/ProgramNovice/article/details/149292713

Rust Web 全栈开发（六）：在 Web 项目中使用 MySQL 数据库

Rust Web 全栈开发（六）：在 Web 项目中使用 MySQL 数据库

参考视频：https://www.bilibili.com/video/BV1RP4y1G7KF

继续使用之前的 Actix 项目。

配置项目

打开 Cargo.toml，把 edition 改成 “2021”。

修改 [dependencies] 部分：

actix-web="4.1.0"
actix-rt="2.7.0"
dotenv = "0.15.0"
chrono = {version = "0.4.19", features = ["serde"]}
serde = {version = "1.0.140", features = ["derive"]}
sqlx = {version = "0.6.0", default_features = false, features = [
    "mysql",
    "runtime-tokio-rustls",
    "macros",
    "chrono",
]}

注意：在添加 crate 时，注意使用版本要相互兼容，否则会出现编译警告。具体需要访问 crates.io 来查看合适的版本。

在终端执行命令 cargo build，构建成功：

在这里插入图片描述

修改 AppState

把 state.rs 修改为：

use std::sync::Mutex;
// use super::models::Course;
use sqlx::MySqlPool;

pub struct AppState {
    pub health_check_response: String,
    pub visit_count: Mutex<u32>,
    // pub courses: Mutex<Vec<Course>>,
    pub db: MySqlPool,
}

现在，课程不再存储在内存中，而是存储在 MySQL 数据库中。

修改 Course

打开 models.rs，让 Course 结构体实现 sqlx::FromRow trait，便于读取数据时的数据转换。

#[derive(Deserialize, Serialize, sqlx::FromRow, Debug, Clone)]
pub struct Course {
    pub teacher_id: i32,
    pub id: Option<i32>,
    pub name: String,
    pub time: Option<NaiveDateTime>,
}

数据库准备

在这里插入图片描述

新建一个名为 course 的 MySQL 数据库，再新建一个名为 course 的表：

在这里插入图片描述

time 如果用 timestamp 类型的话，会报错：error[E0277]: the trait bound `NaiveDate: From<DateTime>` is not satisfied，原因是：the trait `From<DateTime>` is not implemented for `NaiveDate`。

time 如果用 date 类型的话，会报错：mismatched types，原因是：Rust type `core::option::Option<chrono::naive::datetime::NaiveDateTime>` (as SQL type `DATETIME`) is not compatible with SQL type `DATE`。

内容如下：

在这里插入图片描述

连接请求

在 webservice 目录下，新建名为 .env 的文件，在文件内写入请求 URL，形如：

DATABASE_URL=mysql://{user}:{password}@{IP}:{port}/{database name}

这里，我的请求 URL 是：

DATABASE_URL=mysql://root:12138@127.0.0.1:3306/course

读取 MySQL 数据库

在 webservice/src 目录下新建 db_access.rs，实现访问 MySQL 数据库，执行 SQL 语句的功能。

use super::models::*;
use sqlx::MySqlPool;

pub async fn get_courses_for_teacher_db(pool: &MySqlPool, teacher_id: i32) -> Vec<Course> {
    let rows: Vec<Course> = sqlx::query_as(
        "SELECT id, teacher_id, name, time
            FROM course
            WHERE teacher_id = ?"
    )
        .bind(teacher_id)
        .fetch_all(pool) // 获取所有记录
        .await
        .unwrap();

    rows.iter()
        .map(|r| Course {
            id: Some(r.id.expect("Unknown")),
            teacher_id: r.teacher_id,
            name: r.name.clone(),
            time: Some(chrono::NaiveDateTime::from(r.time.unwrap())),
        })
        .collect()
}

pub async fn get_course_details_db(pool: &MySqlPool, teacher_id: i32, course_id: i32) -> Course {
    let row: Course = sqlx::query_as(
        "SELECT id, teacher_id, name, time
            FROM course
            WHERE teacher_id = ? and id = ?"

    )
        .bind(teacher_id)
        .bind(course_id)
        .fetch_one(pool) // 获取单条记录
        .await
        .unwrap();

    Course {
        id: Some(row.id.expect("Unknown")),
        teacher_id: row.teacher_id,
        name: row.name.clone(),
        time: Some(chrono::NaiveDateTime::from(row.time.unwrap())),
    }
}

pub async fn post_new_course_db(pool: &MySqlPool, new_course: Course) -> Result<(), sqlx::Error> {
    let _insert_query = sqlx::query!(
        "INSERT INTO course (id, teacher_id, name, time)
            VALUES (?, ?, ?, ?)",
        new_course.id.unwrap(),
        new_course.teacher_id,
        new_course.name,
        new_course.time
    )
        .execute(pool)
        .await?;

    Ok(())
}

其他修改

修改 teacher_service.rs，把 db_access.rs 的路径添加进去。

把读取 MySQL 数据库的内容添加进去，再对 AppState 实例的构建的代码进行修改。

use actix_web::{web, App, HttpServer};
use std::sync::Mutex;
use dotenv::dotenv;
use sqlx::mysql::MySqlPoolOptions;
use std::env;
use std::io;

#[path = "../handlers.rs"]
mod handlers;
#[path = "../models.rs"]
mod models;
#[path = "../routers.rs"]
mod routers;
#[path = "../state.rs"]
mod state;
#[path = "../db_access.rs"]
mod db_access;

use routers::*;
use state::AppState;

#[actix_rt::main]
async fn main() -> io::Result<()> {
    // 检测并读取 .env 文件中的内容，若不存在也会跳过异常
    dotenv().ok();

    let db_url = env::var("DATABASE_URL")
        .expect("DATABASE_URL 没有在 .env 文件里设置");
    
    // 创建数据库连接池
    let db_pool = MySqlPoolOptions::new()
        .connect(&db_url)
        .await
        .unwrap();
    
    let shared_data = web::Data::new(AppState {
        health_check_response: "I'm OK.".to_string(),
        visit_count: Mutex::new(0),
        // courses: Mutex::new(vec![]),
        db: db_pool,
    });
    
    let app = move || {
        App::new()
            .app_data(shared_data.clone())
            .configure(general_routes)
            .configure(course_routes)
    };

    HttpServer::new(app).bind("127.0.0.1:3000")?.run().await
}

修改 handlers.rs，对数据库的操作都调用 db_access.rs 中的函数

use super::state::AppState;
use actix_web::{web, HttpResponse};
use super::models::Course;
use super::db_access::*;

pub async fn health_check_handler(app_state: web::Data<AppState>) -> HttpResponse {
    println!("incoming for health check");

    let health_check_response = &app_state.health_check_response;
    let mut visit_count = app_state.visit_count.lock().unwrap();
    let response = format!("{} {} times", health_check_response, visit_count);
    *visit_count += 1;

    HttpResponse::Ok().json(&response)
}

pub async fn new_course(
    new_course: web::Json<Course>,
    app_state: web::Data<AppState>,
) -> HttpResponse {
    let _result = post_new_course_db(&app_state.db, new_course.into()).await;

    HttpResponse::Ok().json("Course added")
}

pub async fn get_courses_for_teacher(
    app_state: web::Data<AppState>,
    params: web::Path<i32>,
) -> HttpResponse {
    let teacher_id = params.into_inner();
    let courses = get_courses_for_teacher_db(&app_state.db, teacher_id).await;

    HttpResponse::Ok().json(courses)
}

pub async fn get_course_detail(
    app_state: web::Data<AppState>,
    params: web::Path<(i32, i32)>,
) -> HttpResponse {
    let (teacher_id, course_id) = params.into_inner();
    let course = get_course_details_db(&app_state.db, teacher_id, course_id).await;

    HttpResponse::Ok().json(course)
}

#[cfg(test)]
mod tests {
    use super::*;
    use actix_web::http::StatusCode;
    use std::sync::Mutex;
    use dotenv::dotenv;
    use sqlx::mysql::MySqlPoolOptions;
    use std::env;
    use chrono::{NaiveDate, NaiveDateTime, NaiveTime};

    #[actix_rt::test]
    async fn post_course_test() {
        // 检测并读取 .env 文件中的内容，若不存在也会跳过异常
        dotenv().ok();

        let db_url = env::var("DATABASE_URL")
            .expect("DATABASE_URL 没有在 .env 文件里设置");

        // 创建数据库连接池
        let db_pool = MySqlPoolOptions::new()
            .connect(&db_url)
            .await
            .unwrap();

        let course = web::Json(Course {
            teacher_id: 1,
            name: "Test course".into(),
            id: Some(3),
            time: Some(NaiveDateTime::new(
                NaiveDate::from_ymd_opt(2025, 7, 12).expect("Unknown date"),
                NaiveTime::from_hms_opt(10, 15, 0).expect("Unknown time"),
            )),
        });

        let app_state: web::Data<AppState> = web::Data::new(AppState {
            health_check_response: "".to_string(),
            visit_count: Mutex::new(0),
            db: db_pool,
        });

        // 模拟添加课程的请求
        let response = new_course(course, app_state).await;

        assert_eq!(response.status(), StatusCode::OK);
    }

    #[actix_rt::test]
    async fn get_all_courses_success() {
        // 检测并读取 .env 文件中的内容，若不存在也会跳过异常
        dotenv().ok();

        let db_url = env::var("DATABASE_URL")
            .expect("DATABASE_URL 没有在 .env 文件里设置");

        // 创建数据库连接池
        let db_pool = MySqlPoolOptions::new()
            .connect(&db_url)
            .await
            .unwrap();

        let app_state: web::Data<AppState> = web::Data::new(AppState {
            health_check_response: "".to_string(),
            visit_count: Mutex::new(0),
            db: db_pool,
        });

        let teacher_id: web::Path<i32> = web::Path::from(1);
        let response = get_courses_for_teacher(app_state, teacher_id).await;

        assert_eq!(response.status(), StatusCode::OK);
    }

    #[actix_rt::test]
    async fn get_one_course_success() {
        // 检测并读取 .env 文件中的内容，若不存在也会跳过异常
        dotenv().ok();

        let db_url = env::var("DATABASE_URL")
            .expect("DATABASE_URL 没有在 .env 文件里设置");

        // 创建数据库连接池
        let db_pool = MySqlPoolOptions::new()
            .connect(&db_url)
            .await
            .unwrap();

        let app_state: web::Data<AppState> = web::Data::new(AppState {
            health_check_response: "".to_string(),
            visit_count: Mutex::new(0),
            db: db_pool,
        });

        let params: web::Path<(i32, i32)> = web::Path::from((1, 1));
        let response = get_course_detail(app_state, params).await;

        assert_eq!(response.status(), StatusCode::OK);
    }
}

测试

在终端执行命令 cargo test --bin teacher_service，三个测试都通过了：

在这里插入图片描述

成功向 MySQL 数据库插入了一条数据：

在这里插入图片描述

cd 到 webservice，执行命令 cargo run，在浏览器中测试两个查询功能，都成功了：

在这里插入图片描述

在这里插入图片描述

尾声

视频教程 中使用的是 PostgreSQL 数据库，本文使用的是 MySQL 数据库，在代码方面存在很多细微的差异（集中体现在 db_access.rs 中 SQL 语句的写法），请读者仔细比对。

【Rust操作MySql】Actix Web 框架结合 MySQL 数据库进行交互
景天科技苑
07-01 6298
在 Rust 中，使用 Actix Web 框架结合 MySQL 数据库进行交互，通常可以通过 sqlx、diesel、mysql_async 等库实现。 本文就使用 Actix Web + sqlx + MySQL 的最常见组合示例，包括设置、连接池、路由处理和查询执行等进行详细阐述。
【Actix Web】Rust Web开发JWT认证
景天科技苑
06-30 1097
在现代 Web 开发中，JWT（JSON Web Token）是一种常用的无状态认证方式。通过 JWT，服务端可以发放加密令牌给客户端，客户端每次请求时携带此令牌，服务器通过验证令牌来识别用户身份，省去了服务器端存储会话信息的负担。 Rust 作为一门性能与安全兼备的系统级编程语言，结合 Actix Web 框架开发高性能 Web 应用，成为后端开发的新趋势。
Rust Web 全栈开发（五）：使用 sqlx 连接 MySQL 数据库
ProgramNovice的博客
07-12 353
Rust Web 全栈开发（五）：使用 sqlx 连接 MySQL 数据库
Rust Web 全栈开发（七）：错误处理
最新发布
ProgramNovice的博客
07-13 444
Rust Web 全栈开发（七）：错误处理
Rust Web 全栈开发（八）：添加功能并重构
ProgramNovice的博客
07-13 193
Rust Web 全栈开发（八）：添加功能并重构
Rust Web入门（六）：服务器端web应用
weixin_46463785的博客
03-06 1637
本教程笔记来自 杨旭老师的 rust web 全栈教程，链接如下：学习 Rust Web 需要学习 rust 的前置知识可以学习杨旭老师的另一门教程项目的源代码可以查看 git：（注意作者使用的是 mysql 数据库而不是原教程的数据库）在之前的项目中，我们已经使用了 rust 编写了一些具有增删改查功能的接口并且进行测试，但是作为一款完整的应用，他还需要将这些数据展示到页面中的功能；
Rust Web入门（一）：TCP 和 HTTP Server
weixin_46463785的博客
02-17 2178
本教程笔记来自 杨旭老师的 rust web 全栈教程，链接如下：https://www.bilibili.com/video/BV1RP4y1G7KF?p=1&vd_source=8595fbbf160cc11a0cc07cadacf22951学习 Rust Web 需要学习 rust 的前置知识可以学习杨旭老师的另一门教程https://www.bilibili.com/video/BV1hp4y1k7SV/?spm_id_from=333.999.0.0&vd_source=8595fbbf160cc
Rust Web入门（四）：错误处理
weixin_46463785的博客
02-26 1126
本教程笔记来自 杨旭老师的 rust web 全栈教程 今天来学习基于 rust 的web应用怎么样处理错误
Rust Web入门（七）：WebAssembly
weixin_46463785的博客
03-08 1638
本教程笔记来自 杨旭老师的 rust web 全栈教程，项目的源代码可以查看 git：（注意作者使用的是 mysql 数据库而不是原教程的数据库） https://github.com/aiai0603/rust_web_mysql 在之前的项目中，我们使用 rust 的模板引擎 Tera 编写一个项目，这节课我们来介绍一种 Rust 提供的更加高级的功能来编写前端应用—— WebAssembly，这是官方文档 https://rustwasm.github.io/docs/book/
Rust通用代码生成器：莲花-Rust资源
04-05
尤其适合需要快速开发稳定可靠Web应用的开发者，以及在多种数据库环境中保持开发和部署一致性的工作场景。 该资源包还包括了详细的文档说明，例如History.md和readme.txt文件，这些文档能够帮助用户了解工具的更新...
【Actix Web ORM】Rust ORM框架SeaORM应用实战
景天科技苑
07-02 5816
Rust 语言以其高性能和内存安全特性逐渐在后端开发中崭露头角。Actix Web 是一个强大而灵活的异步 Web 框架，而 SeaORM 是 Rust 中流行且现代的异步 ORM。 两者结合，可以实现类型安全、性能优越的 Web 应用开发。
选择最佳数据库：PostgreSQL、MySQL与MongoDB的全面对决！
希望我的博客，能帮上你解决学习中工作中所遇到的问题
01-22 1464
•：在查询和删除操作中表现出色，适合对数据检索和清理速度要求高的应用。•MySQL 9.0：在批量插入方面表现优异，适合需要快速处理大量数据的场景。•：在单条插入性能上领先，但在查询和批量插入方面则逊色于MySQL。
Redis概念和基础
埃泽漫笔
07-11 237
Redis是一款内存高速缓存数据库。（远程数据服务），使用C语言编写，Redis是一个key-value存储系统（键值存储系统），支持丰富的数据类型，如：String、list、set、zset、hash。Redis是一种支持key-value等多种数据结构的存储系统。可用于缓存，事件发布或订阅，高速队列等场景。支持网络，提供字符串，哈希，列表，队列，集合结构直接存取，基于内存，可持久化。
MySQL事务介绍
wszhj_的博客
07-09 1004
事务是MySQL中的多个（或一个）sql语句。如果这些语句都被成功执行，并且成功提交后，将会永久更改数据；否则将会Rollback（回滚到之前的版本）。事务的四大属性原子性 (Atomicity)：原子性确保事务是一个不可分割的工作单位；事务中的操作要么全部完成，要么全部不执行，不存在部分完成的情况。如果事务过程中遇到错误，系统会自动回滚到事务开始前的状态。一致性 (Consistency)：一致性保证了事务必须将数据库从一种一致状态转换为另一种一致状态。
WebLogic 作用，以及漏洞原理，流量特征与防御
LIU6636LIU的博客
07-10 206
WebLogic作为企业级Java应用服务器，提供应用部署、事务管理、集群负载等核心功能，广泛应用于金融、电信等关键领域。该服务器存在T3/IIOP反序列化、未授权访问等高危漏洞，攻击者可实现远程代码执行、服务器控制（删库/后门）、数据窃取、挖矿及内网渗透等危害。典型攻击流量具有特定协议特征。防御建议包括：禁用高危协议、及时补丁更新、配置WAF、加强流量监控和实施最小权限原则，以保障系统安全。
第五章 RAG知识库进阶
weixin_45284646的博客
07-12 106
本文介绍了基于Spring AI框架开发RAG（检索增强生成）知识库应用的核心技术与实践要点。主要内容包括：1）RAG工作流程的四个关键环节（文档收集切割、向量转换存储、文档过滤检索、查询增强关联）；2）Spring AI的ETL（抽取、转换、加载）流程实现，重点解析了DocumentReader组件对不同格式文档（JSON、PDF等）的读取方式；3）文档转换（切片）阶段的DocumentTransformer接口应用。文章通过代码示例展示了JsonReader的具体用法，为开发者提供了RAG应用开发的系统
将列表还原为树状结构
楠姐的博客
07-11 166
在需要存储树结构的情况下，一般由于使用的关系型数据库（如 MySQL），是以类似表格的扁平化方式存储数据。因此不会直接将树结构存储在数据库中，通常是通过邻接表、路径枚举、嵌套集或闭包表来存储。其中，邻接表是最常用的方案之一，其存储模型如下：大部分情况下，会交给应用程序来构造树结构。
二刷 黑马点评 部署
qq_34832548的博客
07-09 388
我是mac端的homebrew安装的nginx在homebrew/etc/nginx下复制资料中nginx-1.18.0/conf目录下的nginx.conf文件（记得备份原件）在opt/homebrew/var/www目录下移动资料中的hmdp到此处在命令行输入nginx -s reload。
Oracle存储过程导出数据到Excel：全面实现方案详解
shenjqiang的专栏
07-09 190
本文系统介绍了Oracle存储过程导出Excel的四种技术方案：1）UTL_FILE生成CSV（适用于简单结构化数据）；2）PL/SQL输出HTML格式（快速可视化方案）；3）Java集成Apache POI（处理百万级复杂数据）；4）APEX实现RESTful服务（云环境首选）。通过性能对比显示，10万行以内数据PL/SQL方案效率最优，而大数据量场景建议采用Java异步处理。文章提供了完整代码示例和方案选型决策树，建议根据数据规模（≤50万行选CSV）、格式复杂度（需要图表选Java）和部署环境（云服务
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

UestcXiye

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值