You need to enable JavaScript to run this app. Quarkus集成测试中如何正确mock OIDC,摆脱对真实授权服务器的测试依赖
优惠活动
大模型
产品
解决方案
定价
更多

Quarkus集成测试中如何正确mock OIDC,摆脱对真实授权服务器的测试依赖

Quarkus集成测试跳过OIDC授权服务器校验的实现方案

问题根因说明

  • OidcWiremockTestResource类无法定位:该类属于quarkus-oidc扩展的测试专属工具类,仅在扩展的test-jar产物中存在,常规的主依赖包不会包含该类
  • 注入mock对象仍触发授权服务器连接校验:Quarkus OIDC扩展在应用启动阶段就会执行授权服务器元数据连通性检查,@InjectMock仅覆盖运行时的SecurityIdentity、JsonWebToken对象行为,不会跳过启动阶段的扩展初始化检查逻辑
  • 禁用OIDC扩展导致编译失败:设置quarkus.oidc.enabled=false后,扩展会完全卸载所有安全相关的Bean定义,业务代码中引用的@RolesAllowed、JsonWebToken、SecurityIdentity等依赖会因类/Bean不存在触发编译、启动失败

最佳落地实现

1. 引入缺失的测试依赖,解决OidcWiremockTestResource类找不到的问题

在test作用域下引入quarkus-oidc的test-jar依赖,坐标示例:

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-oidc</artifactId>
    <type>test-jar</type>
    <scope>test</scope>
</dependency>

引入后即可在类路径下找到OidcWiremockTestResource类,不需要额外查找其他来源。

2. 覆盖测试环境配置,跳过启动期的授权服务器连通性校验

不要直接全量禁用OIDC扩展,在测试环境专属配置文件(如application-test.properties)中修改OIDC相关配置,从根源上避免启动阶段对真实授权服务器的请求:

  • 关闭远端元数据发现流程:设置quarkus.oidc.discovery-enabled=false,不再自动从授权服务器拉取配置
  • 配置本地静态公钥路径:通过quarkus.oidc.public-key-location指定测试资源目录下的本地公钥文件,代替从授权服务器拉取token签名公钥的逻辑
  • 关闭不必要的连接校验:设置quarkus.oidc.connection-tls-verify=false,跳过本地模拟服务的TLS校验环节
    对应配置示例:
quarkus.oidc.auth-server-url=http://localhost:18080/realms/test
quarkus.oidc.discovery-enabled=false
quarkus.oidc.public-key-location=classpath:test/jwk-public.json
quarkus.oidc.connection-tls-verify=false

3. 选择适配的测试适配方式

  • 方式一:使用官方WireMock适配
    在测试类上添加@QuarkusTestResource(OidcWiremockTestResource.class)注解,Quarkus会自动启动内置的WireMock服务,模拟授权服务器的所有端点交互,完全不需要本地启动Keycloak等真实服务。
  • 方式二:纯本地静态token解析
    不需要启动任何模拟服务,所有token校验逻辑完全在测试进程内完成,适合简单的接口权限测试场景,配合@InjectMock直接注入自定义的SecurityIdentity、JsonWebToken实例即可,仅需保留上述跳过启动校验的配置,就不会触发对远端授权服务器的连接请求。

避坑提示

  • 禁止直接设置quarkus.oidc.enabled=false,该操作会完全卸载OIDC扩展,导致业务代码中依赖的安全组件全部不可用
  • 单纯使用@InjectMock注入安全对象是不够的,必须配合上述配置跳过启动期的扩展校验,否则应用会在启动阶段因无法连接授权服务器直接报错
  • Quarkus 3.x全版本的OidcWiremockTestResource类均在上述test-jar依赖中,不存在版本路径变更问题

内容的提问来源于stack exchange,提问作者Nacho Cougil

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 12:06:06