Actix Web中Query参数的validator校验未生效问题排查

问题场景 #

使用Actix Web 4作为Web服务器，通过validator库的derive宏定义了请求参数的长度校验规则，但发送超长参数请求时，校验并未触发，接口依然返回200成功。添加actix-web-validator依赖后问题仍未解决。

核心原因 #

Actix Web的web::Query仅负责将URL参数反序列化为结构体，不会自动调用validator的校验逻辑。而actix-web-validator需要替换默认的Query类型才能自动触发校验，仅添加依赖不修改代码是无效的。

修复方案 #

方案一：使用actix-web-validator自动校验 #

1. 确保依赖版本匹配（Actix Web 4对应actix-web-validator 5.x），Cargo.toml中保留：

[dependencies]
# 其他依赖不变
actix-web = "4"
validator = { version = "0.16.1", features = ["derive"] }
actix-web-validator = "5.0.1"

2. 修改代码，用actix_web_validator::Query替代web::Query，它会自动执行校验并返回错误响应：

use actix_web::{get, App, HttpResponse, HttpServer, Responder, web};
use validator::Validate;
// 引入actix-web-validator的Query类型
use actix_web_validator::Query;

#[derive(serde::Deserialize, Validate)]
pub struct AppParams {
    #[validate(length(max = 2))]
    tag: String,
}

#[get("/")]
// 替换为actix_web_validator::Query
async fn hello(params: Query<AppParams>) -> impl Responder {
    HttpResponse::Ok().body("Hello,world!")
}

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    HttpServer::new(|| {
        App::new()
            .service(hello)
    })
    .bind("127.0.0.1:8080")?
    .run()
    .await
}

方案二：手动调用校验逻辑 #

如果不想依赖actix-web-validator，可以在handler中手动调用validate()方法处理校验错误：

use actix_web::{get, App, HttpResponse, HttpServer, Responder, web, error::ErrorBadRequest};
use validator::Validate;

#[derive(serde::Deserialize, Validate)]
pub struct AppParams {
    #[validate(length(max = 2))]
    tag: String,
}

#[get("/")]
async fn hello(params: web::Query<AppParams>) -> impl Responder {
    // 手动触发校验
    if let Err(e) = params.validate() {
        return HttpResponse::BadRequest().body(e.to_string());
        // 或者用Actix的Error类型：return Err(ErrorBadRequest(e.to_string()));
    }
    HttpResponse::Ok().body("Hello,world!")
}

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    HttpServer::new(|| {
        App::new()
            .service(hello)
    })
    .bind("127.0.0.1:8080")?
    .run()
    .await
}

测试验证 #

执行测试命令：

curl http://localhost:8080\?tag\=allallall

此时会返回400 Bad Request，响应内容包含校验错误信息；发送符合长度的参数（如tag=ab）则正常返回"Hello,world!"。

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