如何在Rust Warp中将静态文件打包进可执行文件并作为过滤器？

方法一：手动实现嵌入过滤器 #

如果你的静态文件数量不多，可以直接用include_str!/include_bytes!把文件内容硬编码进代码，再自己写一个Warp过滤器匹配路径并返回内容：

use warp::{Filter, Reply};
use std::collections::HashMap;

// 预加载所有静态文件，和你给出的include_str用法逻辑一致
static STATIC_FILES: &[(&str, &[u8], &str)] = &[
    ("/index.html", include_bytes!("static/index.html"), "text/html"),
    ("/style.css", include_bytes!("static/style.css"), "text/css"),
    ("/script.js", include_bytes!("static/script.js"), "application/javascript"),
];

// 构建路径到文件内容、MIME类型的映射
fn static_files_map() -> HashMap<&'static str, (&'static [u8], &'static str)> {
    STATIC_FILES.iter()
        .map(|(path, content, mime)| (*path, (*content, *mime)))
        .collect()
}

// 自定义静态文件过滤器
fn embedded_static_files() -> impl Filter<Extract = impl Reply, Error = warp::Rejection> + Clone {
    let files = static_files_map();
    warp::path::full()
        .map(move |path: warp::path::FullPath| {
            let path_str = path.as_str();
            match files.get(path_str) {
                Some((content, mime)) => warp::http::Response::builder()
                    .header("Content-Type", mime)
                    .body(content.to_vec())
                    .unwrap(),
                None => warp::http::Response::builder()
                    .status(warp::http::StatusCode::NOT_FOUND)
                    .body("404 Not Found".into())
                    .unwrap(),
            }
        })
}

// 用法示例
#[tokio::main]
async fn main() {
    let routes = embedded_static_files();
    warp::serve(routes).run(([127, 0, 0, 1], 3030)).await;
}

这种方式完全手动控制，不需要额外依赖，适合文件数量少的场景。

方法二：用rust-embed crate批量嵌入 #

如果静态文件数量多、层级复杂，手动写映射太麻烦，可以用rust-embed自动嵌入整个目录的文件，再结合Warp实现过滤器：

先在Cargo.toml添加依赖：

[dependencies]
warp = "0.3"
tokio = { version = "1.0", features = ["full"] }
rust-embed = "6.0"
mime_guess = "2.0" # 自动推断文件MIME类型

然后编写代码：

use warp::{Filter, Reply};
use rust_embed::RustEmbed;
use mime_guess::from_path;

// 指定要嵌入的静态文件目录
#[derive(RustEmbed)]
#[folder = "static/"] // 替换成你的静态文件实际目录
struct Assets;

// 基于rust-embed实现Warp过滤器
fn embedded_assets() -> impl Filter<Extract = impl Reply, Error = warp::Rejection> + Clone {
    warp::path::full()
        .map(|path: warp::path::FullPath| {
            let path_str = path.as_str().trim_start_matches('/');
            // 根路径默认返回index.html
            let path_str = if path_str.is_empty() { "index.html" } else { path_str };

            match Assets::get(path_str) {
                Some(content) => {
                    let mime_type = from_path(path_str).first_or_octet_stream().to_string();
                    warp::http::Response::builder()
                        .header("Content-Type", mime_type)
                        .body(content.data.into_owned())
                        .unwrap()
                }
                None => warp::http::Response::builder()
                    .status(warp::http::StatusCode::NOT_FOUND)
                    .body("404 Not Found".into())
                    .unwrap(),
            }
        })
}

#[tokio::main]
async fn main() {
    let routes = embedded_assets();
    warp::serve(routes).run(([127, 0, 0, 1], 3030)).await;
}

rust-embed会在编译时自动把指定目录下的所有文件（包括嵌套目录）嵌入到可执行文件中，无需手动维护文件列表。

关于其他框架 #

如果愿意更换框架，同属Tokio生态的Axum也支持类似的编译时嵌入方案，逻辑和Warp一致：用rust-embed嵌入文件后，通过路由匹配返回对应内容。

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