Actix Web 4测试路由异常：非根路径请求未触发处理器

问题现象 #

升级至Actix Web 4（版本4.1.0）后，基于actix-web test模块编写的测试中，非根路径的请求处理器无法被调用，仅根路径配置能正常触发处理器逻辑。

问题代码 #

原测试代码如下，请求/index.html时，控制台无预期的Hello?输出：

use actix_web::{test, web, App, HttpResponse, HttpRequest};

#[actix_rt::test]
async fn says_hello() {
  let req = test::TestRequest::get().uri("/index.html").to_request();
  let mut server =
    test::init_service(App::new().service(web::scope("/").route("index.html", web::get().to(|_req: HttpRequest| async {
      println!("Hello?");
      HttpResponse::Ok()
    })))).await;
  let _resp = test::call_and_read_body(&mut server, req).await;
}

解决方案 #

方案1：修正scope内的路由路径 #

将scope内部的route路径改为以/开头，确保路由拼接后与请求URI完全匹配：

use actix_web::{test, web, App, HttpResponse, HttpRequest};

#[actix_rt::test]
async fn says_hello() {
  let req = test::TestRequest::get().uri("/index.html").to_request();
  let mut server =
    test::init_service(App::new().service(web::scope("/").route("/index.html", web::get().to(|_req: HttpRequest| async {
      println!("Hello?");
      HttpResponse::Ok()
    })))).await;
  let _resp = test::call_and_read_body(&mut server, req).await;
}

方案2：移除不必要的scope #

若无需使用scope的路径前缀功能，直接在App上定义路由，避免路径拼接的潜在问题：

use actix_web::{test, web, App, HttpResponse, HttpRequest};

#[actix_rt::test]
async fn says_hello() {
  let req = test::TestRequest::get().uri("/index.html").to_request();
  let mut server =
    test::init_service(App::new().route("/index.html", web::get().to(|_req: HttpRequest| async {
      println!("Hello?");
      HttpResponse::Ok()
    }))).await;
  let _resp = test::call_and_read_body(&mut server, req).await;
}

原因说明 #

Actix Web 4对路由路径的匹配逻辑进行了调整：

• 当使用web::scope时，内部route的相对路径（不以/开头）与scope路径拼接后，可能无法被测试环境的路由匹配器正确识别。
• 明确使用以/开头的绝对路径定义路由，能确保请求URI与路由规则完全匹配，触发对应的处理器逻辑。

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