JHipster网关对接Keycloak：登录错误页面自定义方案咨询

一、让网关显示自定义错误页面（推荐方案） #

你之前修改SpaWebFilter没生效，核心原因是Spring Security的过滤器优先级比SpaWebFilter更高，/login路径会被Security拦截链先处理，你的过滤器逻辑根本没机会执行。可以通过以下两种方式解决：

方式1：自定义OAuth2登录失败处理器 #

在JHipster生成的SecurityConfiguration类中，给oauth2Login配置失败处理器，直接重定向到你的自定义错误页面：

@Bean
public SecurityWebFilterChain springSecurityFilterChain(ServerHttpSecurity http) {
    // 保留原有配置...
    http.oauth2Login(oauth2 -> oauth2
        .failureHandler((exchange, exception) -> {
            // 重定向到你的自定义登录错误页面路径
            ServerHttpResponse response = exchange.getResponse();
            response.setStatusCode(HttpStatus.SEE_OTHER);
            response.getHeaders().setLocation(URI.create("/error/login"));
            return response.setComplete();
        })
    );
    // 其他配置...
    return http.build();
}

方式2：添加专门的路由转发规则 #

在网关中创建一个RouterFunction Bean，针对/login?error请求直接转发到自定义错误页面，这个路由的优先级高于Spring Security默认路由：

@Bean
public RouterFunction<ServerResponse> loginErrorRoute() {
    return RouterFunctions.route(RequestPredicates.path("/login")
            .and(RequestPredicates.queryParam("error", "error")),
        request -> ServerResponse.temporaryRedirect(URI.create("/error/login")).build()
    );
}

二、修改Keycloak的重定向逻辑（替代方案） #

如果不想修改网关代码，可直接在Keycloak控制台调整客户端配置，让登录错误时直接重定向到自定义页面：

• 登录Keycloak管理控制台，找到网关对应的客户端
• 进入高级设置标签页
• 在错误URI字段中，填入自定义错误页面的完整地址（比如https://my-gateway-url/error/login）
• 保存配置后，Keycloak登录出错时会直接跳转到该地址，绕过网关的/login?error路径

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