Keycloak+HtmlUnit实现OIDC登录自动化测试回调无响应问题求助

排查方向 #

• 等待逻辑缺失：现有代码调用buttonLogin.click()后没有等待页面跳转、后台JavaScript执行完成，try块直接退出导致WebClient被提前关闭，登录后的重定向请求还未发出就被终止
• 元素获取错误：通过name="login"获取按钮可能匹配到页面其他同name元素，或者按钮点击事件被Keycloak的onsubmit逻辑拦截未触发提交
• 服务器绑定错误：HttpServer绑定的地址通过InetAddress.getLocalHost().getHostAddress()获取，若本机存在多网卡、hosts配置异常，可能绑定到非OIDC请求中redirect_uri指定的IP，导致Keycloak回调无法到达
• JavaScript执行异常：HtmlUnit对前端JavaScript兼容性有限，Keycloak登录页的JS逻辑如果执行报错，会阻断表单提交流程
• 参数解析错误：即使回调请求到达，现有代码直接截取code=后的内容，若URL存在其他参数（如state、error）会导致解析失败，误以为没有收到回调

解决方案 #

• 补充等待逻辑：调用点击后主动等待跳转和JS执行完成，修改代码如下：

HtmlSubmitInput buttonLogin = (HtmlSubmitInput) form.getInputByName("login");
// 接住点击后返回的页面，触发完整跳转流程
HtmlPage afterLogin = buttonLogin.click();
// 等待最长5秒的后台JS执行
webClient.waitForBackgroundJavaScript(5000);

• 优化元素获取逻辑：优先用唯一id获取按钮，或者直接触发表单提交，避免点击异常：

// 方式1：通过id获取登录按钮更稳妥
HtmlSubmitInput buttonLogin = (HtmlSubmitInput) page.getElementById("kc-login");
// 方式2：直接提交表单，绕开按钮点击的兼容性问题
form.submit();

• 修复HttpServer绑定配置：直接指定和redirect_uri一致的监听地址，同时添加日志确认请求是否到达：

// 直接指定回调中使用的IP，避免自动获取错误
HttpServer server = HttpServer.create(new InetSocketAddress("192.168.202.102", 8001), 0);
server.createContext("/oidc_test_callback", new HttpHandler() {
    @Override
    public void handle(HttpExchange exchange) throws IOException {
        // 先打印所有收到的请求，确认回调是否到达
        System.out.println("Received request: " + exchange.getRequestURI());
        String query = exchange.getRequestURI().getQuery();
        // 用更稳妥的方式解析code参数
        String codeValue = Arrays.stream(query.split("&"))
                .filter(p -> p.startsWith("code="))
                .map(p -> p.substring(5))
                .findFirst()
                .orElse(null);
        // 返回200响应，避免请求超时
        exchange.sendResponseHeaders(200, -1);
        exchange.close();
    }
});

• 调整HtmlUnit兼容性配置：关闭非必要的JS异常抛出，避免中断流程：

webClient.getOptions().setThrowExceptionOnScriptError(false);
webClient.getOptions().setCssEnabled(false); // CSS不影响登录逻辑可关闭

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