Vert.x 5.0.0 SNAPSHOT中OpenAPI路由JWT授权配置报错求助

问题分析 #

你遇到的java.lang.NullPointerException: 'securityScheme' cannot be null异常，核心原因有两个：

• OpenAPI规范中未定义名为bearerAuth的安全方案，导致RouterBuilder无法找到对应配置
• API调用顺序或方法名错误，未正确完成安全处理器的绑定

解决步骤 #

1. 确认OpenAPI规范中的安全方案定义 #

首先检查你的OpenAPI YAML/JSON文件，确保components.securitySchemes下存在bearerAuth的Bearer认证定义：

components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

2. 修正Vert.x 5代码写法 #

Vert.x 5中RouterBuilder的安全处理器绑定API改为链式调用，需在createRouter()之前完成绑定，且使用handler()方法传递认证处理器（而非你代码中的httpHandler）：

RouterBuilder.create(this.vertx, OPENAPI_URL)
  .compose(routerBuilder -> {
    // 绑定bearerAuth安全方案的JWT处理器
    routerBuilder
      .security("bearerAuth")
      .handler(Config.jwt().getAuthHandler());

    // 创建OpenAPI路由并添加为子路由
    Router openApiRouter = routerBuilder.createRouter();
    router.route("/v1/*").subRouter(openApiRouter);

    return Future.succeededFuture();
  });

关键说明 #

• security("bearerAuth")方法会先从OpenAPI规范中查找同名安全方案，未找到则返回null，进而触发NPE，因此必须保证规范中存在对应配置
• 安全处理器的绑定必须在createRouter()之前完成，否则绑定不会生效
• Vert.x 5的Security对象提供的是handler()方法接收SecurityHandler，而非httpHandler，这是你代码中的另一个潜在错误

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