使用 Actix-Web、SQLx 和 Redis 构建高性能 Rust Web 服务：模块化结构

最新推荐文章于 2025-10-29 13:27:57 发布

原创

最新推荐文章于 2025-10-29 13:27:57 发布 · 1.3k 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#前端 #redis #rust

使用 Actix-Web、SQLx 和 Redis 构建高性能 Rust Web 服务：模块化结构

在本教程中，我们将详细介绍如何在 Windows 系统上使用 Actix-Web 框架、SQLx 数据库工具和 Redis 缓存来构建一个高性能的 Rust Web 服务。我们将创建一个用户管理系统，包括获取单个用户、创建用户和获取所有用户的功能，并通过模块化结构来组织代码，使其更加清晰和易于维护。

什么是 Actix-Web

Actix-Web 是一个用于构建 Web 应用程序的高性能、异步框架，基于 Rust 语言。它具有以下特点：

异步：使用 tokio 和 async-std 等异步运行时，提供高性能和高并发处理能力。
中间件：支持中间件机制，可以方便地扩展功能。
路由：灵活的路由机制，支持路径参数、查询参数等多种路由方式。
类型安全：利用 Rust 的类型系统，确保代码的类型安全性和健壮性。
社区支持：拥有活跃的开发者社区和丰富的文档资源。

准备工作

安装 Rust 和 Cargo

首先，确保你已经安装了 Rust 编程语言和 Cargo 包管理器。你可以在 Rust 官网上找到适用于 Windows 的安装指南。按照提示运行 Rust 安装程序，并在安装过程中选择安装 Visual C++ 构建工具。

安装 MySQL

安装 MySQL 数据库，并设置好对应的环境变量。你可以从 MySQL 官网下载适用于 Windows 的安装程序，并按照官方指南进行安装。

安装 Redis

安装 Redis，并设置好对应的环境变量。你可以从 Redis 官网下载 Windows 版本的安装程序，并按照官方指南进行安装。

创建项目

首先，使用 Cargo 创建一个新的 Rust 项目：

cargo new my_actix_app
cd my_actix_app

添加依赖项

编辑 Cargo.toml 文件，添加所需的依赖项：

[package]
name = "my_actix_app"
version = "0.1.0"
edition = "2021"

[dependencies]
actix-web = "4.0"
sqlx = { version = "0.5", features = ["mysql", "runtime-tokio-native-tls"] }
redis = "0.26"
dotenv = "0.15"
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

创建目录结构

为了更好地组织代码，我们可以创建一个 models 目录来存放数据模型，以及一个 db 目录来存放 SQL 查询逻辑。创建以下目录结构：

my_actix_app/
├── src/
│   ├── main.rs
│   ├── models/
│   │   └── user.rs
│   └── db/
│       └── user_queries.rs
├── .env
└── Cargo.toml

创建数据模型

在 src/models/user.rs 文件中创建用户数据模型：

use serde::{
   
   Deserialize, Serialize};

#[derive(Debug, Serialize, Deserialize)]
pub struct User {
   
   
    pub id: i32,
    pub name: String,
    pub email: String,
}

创建 SQL 查询逻辑

在 src/db/user_queries.rs 文件中创建用户相关的 SQL 查询逻辑：

use sqlx::mysql::MySqlPool;
use crate::models::User;
use sqlx::Error;

// 获取单个用户
pub async fn get_user_by_id(pool: &MySqlPool, user_id: i32) -> Result<Option<User>, Error> {
   
   
    sqlx::query_as!(
        User,
        r#"
        SELECT id, name, email FROM users WHERE id = ?
        "#,
        user_id
    )
    .fetch_optional(pool)
    .await
}

// 创建新用户
pub async fn create_user(pool: &MySqlPool, name: String