actix-web启动Actor触发spawn_local相关panic该如何解决？

云上老周

2026-9-30

问题根因

你遇到的panic核心是依赖版本不兼容，你的实现逻辑本身没有问题。
actix-web 3.3.2依赖actix-rt 1.x运行时，而actix 0.12.0依赖actix-rt 2.x运行时：

两个版本的actix-rt底层对tokio的LocalSet管理逻辑完全不同
actix-web 3的#[actix_web::main]是重导出的actix-rt 1.x的主宏，无法满足actix 0.12对运行时环境的要求，所以启动Actor调用spawn_local时找不到对应的LocalSet触发panic
你替换为#[actix_rt::main]能正常运行，是因为你项目里实际依赖的是actix-rt 2.x版本，运行时环境匹配，但这种跨版本混用运行时的方式存在隐形风险，不建议长期使用。

解决方案

有两种稳定的修复方案可选：

方案1：升级actix-web到4.x版本（推荐）

actix-web 4.x默认使用actix-rt 2.x运行时，和actix 0.12完全兼容。

修改Cargo.toml依赖：

actix-web = "4"
actix = "0.12"

调整代码中状态注册的写法（actix-web 4将.data()方法替换为.app_data()，需要手动包裹web::Data）：

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    let addr = MyActor.start();
    
    HttpServer::new(move || {
        App::new()
            .app_data(web::Data::new(AppState {
                actor_addr: addr.clone(),
            }))
            .route("/", web::get().to(greet))
    })
    .bind(("127.0.0.1", 8080))?
    .run()
    .await
}