Axum Web 框架简介

Axum 是由 Tokio 团队维护的一款 Rust Web 框架，专注于提供人体工程学（ergonomics）和模块化的 HTTP 路由与请求处理体验。它构建在 Hyper 和 Tower 生态之上，非常轻量，几乎不引入额外开销，性能可与 Hyper 直接媲美。

核心特点

• 无宏的声明式 API：通过 Router 和 method 路由（如 get、post）定义端点，无需使用宏，代码清晰直观。
• 强大的提取器：从请求中提取数据（如 JSON、路径参数、查询字符串）声明式且类型安全。
• 统一的错误处理：框架具有简单、可预测的错误模型，可轻松转换为响应。
• 响应构建极简：从处理函数返回的类型自动转换为响应，支持状态码、JSON 等。
• 完整的 Tower 生态集成：可直接使用 Tower 提供的中间件（超时、追踪、压缩、认证等），并可与其他 Tower 服务（如 Tonic gRPC）共享中间件。

适用场景

• 构建高性能 RESTful API 或微服务。
• 需要与 Tokio 异步运行时紧密结合的后端服务。
• 希望利用 Tower 中间件生态提升可组合性和可维护性的项目。
• 开发者偏好安全、零 unsafe 的 Rust 代码。

使用方式

在 Cargo.toml 中添加依赖 axum，并配合 tokio 异步运行时。基本用法是创建 Router，通过 .route() 方法绑定路径与处理函数，然后使用 axum::serve 启动服务。Axum 的文档和 examples 目录提供了丰富的示例，从基础路由到数据库集成、WebSocket 和流式响应均有覆盖。

注意事项

Axum 仍处于积极开发中，主分支可能包含破坏性变更。当前稳定版本为 0.8.x，建议生产项目锁定该版本。最低支持的 Rust 版本为 1.80。Axum 本身完全使用安全的 Rust 实现（#![forbid(unsafe_code)]），并采用 MIT 许可。