Quarkus 3.9.2集成Keycloak Devservice认证后出现空白页问题

1. 校验重定向URI的合法性 #

从你提供的登录表单URL来看，redirect_uri指向Dev UI的Keycloak Provider路径：http://localhost:8080/q/dev-ui/io.quarkus.quarkus-oidc/keycloak-provider

• 先确认Dev UI本身是否正常：直接访问http://localhost:8080/q/dev-ui，若页面无法打开，说明Dev UI加载异常是重定向空白的直接原因
• 手动检查Keycloak客户端配置：登录Keycloak控制台（http://localhost:45180/admin），进入quarkus realm → Clients → quarkus-app，确认Valid Redirect URIs列表包含上述redirect_uri，若缺失则添加后重启Quarkus应用

2. 查看浏览器控制台错误信息 #

重定向到空白页时，按F12打开开发者工具→Console标签，排查以下问题：

• 是否有Dev UI相关JS资源加载失败，导致页面无法渲染
• 若出现CORS报错，临时添加Dev环境CORS配置：

%dev.quarkus.http.cors=true
%dev.quarkus.http.cors.origins=http://localhost:45180
%dev.quarkus.http.cors.methods=GET,POST,OPTIONS

3. 补充OIDC核心配置参数 #

Quarkus 3.9.x对OIDC Devservice的自动配置可能存在兼容性问题，尝试显式添加核心配置：

%dev.quarkus.oidc.auth-server-url=http://localhost:45180/realms/quarkus
%dev.quarkus.oidc.client-id=quarkus-app
%dev.quarkus.oidc.credentials.secret=替换为Keycloak客户端的密钥

密钥可从Keycloak控制台的quarkus-app客户端→Credentials标签获取

4. 绕过Dev UI直接测试API端点 #

暂时跳过Dev UI的认证流程，直接访问受保护的API端点（如http://localhost:8080/your-protected-endpoint）：

• 若直接访问能正常完成认证，说明问题出在Dev UI与OIDC的集成上，可尝试更新Quarkus Dev UI扩展版本
• 若直接访问也出现重定向问题，检查quarkus.oidc.redirect-path配置（默认是/callback），确保Keycloak客户端的重定向URI包含该路径

5. 开启调试日志定位根源 #

添加日志配置，查看OIDC认证过程的详细报错：

%dev.quarkus.log.category."io.quarkus.oidc".level=DEBUG
%dev.quarkus.log.category."org.keycloak".level=DEBUG

启动应用后完成登录操作，从日志中查找认证失败、令牌解析错误或重定向URI不匹配的具体提示

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