Angular 5集成Keycloak JS适配器：页面刷新重定向至登录页问题

我之前也碰到过一模一样的问题，折腾了好一阵才捋清楚原因，给你分享几个排查和解决的方向：

1. 先确认Keycloak初始化的时机和配置细节 #

首先得保证Keycloak的初始化是在Angular应用启动之前完成的，比如用APP_INITIALIZER来触发初始化——如果初始化太晚，页面已经开始加载了才去做认证检查，就会出现刷新就跳登录页的错觉。

另外仔细核对init的配置，除了onLoad: 'login-required'，这几个选项别搞错：

• checkLoginIframe要设为true（默认是true，但如果手动改成false，适配器就没法检测已有的Keycloak会话了）
• 绝对不要加prompt: 'login'，这个参数会强制每次都弹出登录页，直接跳过会话检测

给你个初始化的示例代码参考：

import { KeycloakService } from './keycloak.service';
import { APP_INITIALIZER } from '@angular/core';

export function keycloakInitializer(keycloak: KeycloakService): () => Promise<any> {
  return () => keycloak.init({
    config: {
      url: 'https://你的Keycloak域名/auth',
      realm: '你的Realm名称',
      clientId: '你的客户端ID'
    },
    initOptions: {
      onLoad: 'login-required',
      checkLoginIframe: true
      // 这里千万别加prompt: 'login'！
    }
  });
}

@NgModule({
  providers: [
    KeycloakService,
    {
      provide: APP_INITIALIZER,
      useFactory: keycloakInitializer,
      multi: true,
      deps: [KeycloakService]
    }
  ]
})
export class AppModule {}

2. 检查Keycloak会话Cookie的配置 #

Keycloak是靠Cookie维护会话的，刷新页面时适配器得能读到这些Cookie才能识别已登录状态，这里容易踩坑的点：

• SameSite属性：如果你的Angular应用和Keycloak不在同一个域名下，要确保Keycloak的Cookie设置了SameSite=None，同时开启Secure（得用HTTPS）——不然浏览器在跨域场景下不会发送Cookie，适配器自然检测不到会话。
• Cookie路径：看看Keycloak的Cookie路径是不是/auth或者正确的根路径，路径不匹配的话浏览器也不会读取。
• 过期时间：确认会话Cookie的过期时间设置合理，别被提前清掉了。

你可以打开浏览器开发者工具的Application标签，找找以KEYCLOAK_开头的Cookie，刷新页面后看看这些Cookie还在不在，属性是不是符合要求。

3. 核对Keycloak客户端的后台配置 #

登录Keycloak管理后台，检查你的客户端配置：

• Access Type必须设为public——Angular是SPA，属于公共客户端，不能用机密客户端的配置。
• Valid Redirect URIs要包含你Angular应用的所有路由，比如http://localhost:4200/*，不然刷新后重定向URI不匹配，会直接导致会话失效。
• Web Origins要设置正确，开发环境可以暂时设为*，生产环境建议严格指定你的应用域名。

4. 排查浏览器的缓存和隐私设置 #

有时候浏览器的隐私设置（比如禁用第三方Cookie）会导致Keycloak的会话Cookie读不到，尤其是跨域场景下。你可以先开隐私模式测试，如果问题消失，那就是浏览器的Cookie设置在搞鬼。

另外也可以清一下浏览器缓存和Keycloak相关的Cookie，重新登录试试，避免旧的无效Cookie干扰。

5. 加日志调试会话检测逻辑 #

你可以在keycloak.init()的回调里加些日志，看看适配器到底有没有检测到会话：

keycloak.init({/* 你的配置 */}).then(authenticated => {
  console.log('当前认证状态:', authenticated);
  if (!authenticated) {
    // 试试主动刷新令牌，看能不能恢复会话
    keycloak.updateToken(5).then(refreshed => {
      console.log('令牌是否刷新成功:', refreshed);
    }).catch(err => {
      console.error('令牌刷新失败:', err);
    });
  }
}).catch(err => {
  console.error('Keycloak初始化失败:', err);
});

通过日志就能判断，是适配器根本没检测到会话，还是检测到了但后续出了问题。

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