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
相关产品推荐
相关产品推荐

