Vertx Web路由丢失请求参数问题排查求助

核心原因：Vertx Web默认不自动解析JSON请求体 #

Vertx Web和Spring Boot的请求处理逻辑存在设计差异：Spring MVC会自动根据请求的Content-Type解析请求体并映射到参数容器，但Vertx Web是轻量级框架，默认不会主动读取并解析application/json类型的请求体，你看到的params和queries中的null条目只是默认初始化的空槽，并非实际参数。

解决步骤 #

• 注册请求体解析处理器
  必须在路由规则前显式添加BodyHandler，它负责读取并解析各类请求体（JSON、表单等）。如果缺少这个处理器，Vertx不会读取请求体内容，自然拿不到参数。
  示例代码：

  Router router = Router.router(vertx);
  // 必须将BodyHandler注册在所有路由规则之前
  router.route().handler(BodyHandler.create());
  

• 正确读取JSON参数
  注册BodyHandler后，不能通过request.params()获取JSON参数，需要从解析后的请求体JSON对象中读取：

  router.post("/your-api-path").handler(ctx -> {
    JsonObject requestBody = ctx.getBodyAsJson();
    String theText = requestBody.getString("theText");
    // 后续业务处理逻辑
  });
  

• 验证请求头格式
  确认前端请求的Content-Type头为application/json，如果前端实际发送的是application/x-www-form-urlencoded类型的表单参数，才需要用ctx.request().params().get("theText")获取，但这种情况Spring Boot也会正常解析，所以优先检查请求头是否符合JSON格式要求。

结论 #

这不是Vertx的Bug，而是Vertx Web的轻量级设计导致的配置差异——需要开发者显式配置请求体解析器，而非框架自动完成。

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