框架集成
English | 中文
各 Web 插件共享 sa-token-plugin-common 里的 SaTokenState。中间件走同一套 run_auth_flow；读 token 统一经 core 的 token_io（Header / Cookie / Body + 可选 token_prefix）。
SaTokenState
rust
use sa_token_plugin_axum::*; // 或其它插件门面
use std::sync::Arc;
let state = SaTokenState::builder()
.storage(Arc::new(MemoryStorage::new()))
.token_name("Authorization")
.timeout(86400)
.is_read_header(true)
.build(); // 内部 try_init_manager；库代码也可 SaTokenConfig::try_build不要再依赖已删除的 sa-token-plugin-*-core。
Axum：Layer + Extractor
rust
use axum::{Router, routing::{get, post}};
use sa_token_plugin_axum::*;
let path_auth = PathAuthConfig::new()
.include(vec!["/**".into()])
.exclude(vec!["/api/login".into(), "/api/health".into()]);
let app = Router::new()
.route("/api/login", post(login))
.route("/api/me", get(me))
.layer(SaTokenLayer::with_path_auth(state.clone(), path_auth))
.with_state(state);
async fn me(SaTokenExtractor(token): SaTokenExtractor) -> String {
token.as_str().to_string()
}
// 另有 OptionalSaTokenExtractor、LoginIdExtractor公开路由必须 PathAuthConfig::exclude；#[sa_ignore] 只跳过宏检查，不跳过 Layer。
Actix-web：Middleware
门面默认 v4。feature v5 仅为占位，单独启用会 compile_error!，生产请用 v4。
toml
sa-token-plugin-actix-web = "0.2.0" # default features = ["v4", ...]rust
use actix_web::{App, HttpServer, web};
use sa_token_plugin_actix_web::*;
HttpServer::new(move || {
App::new()
.app_data(web::Data::new(state.clone()))
.wrap(SaTokenMiddleware::with_path_auth(
state.clone(),
PathAuthConfig::new()
.include(vec!["/**".into()])
.exclude(vec!["/api/login".into()]),
))
.route("/api/login", web::post().to(login))
})其它插件（短表）
| 框架 | Crate | 说明 |
|---|---|---|
| Poem | sa-token-plugin-poem | SaTokenLayer::with_path_auth |
| Warp | sa-token-plugin-warp | 一体化 |
| Tide | sa-token-plugin-tide | 一体化 |
| Rocket | sa-token-plugin-rocket | 门面，feature 选大版本 |
| Salvo | sa-token-plugin-salvo | 门面 |
| Gotham | sa-token-plugin-gotham | 门面 |
| Ntex | sa-token-plugin-ntex | 门面 |
| Tonic | sa-token-plugin-tonic | gRPC Layer + PathAuth |
Token 读取（token_io）
插件适配器把请求变成 SaRequest 后调用：
token_io::read_token— 按is_read_header/is_read_cookie/is_read_body与token_nameapply_token_prefix— 可选前缀- 写回：
is_write_cookie+write_token_cookie
WebSocket 握手的 map 形态见 read_token_from_maps（WebSocket 鉴权）。