Next.js集成KeycloakProvider跳转登录页时提示Invalid Username or Password

针对你遇到的「未进入Keycloak登录页直接提示无效用户名/密码」问题，按以下步骤排查：

1. 优先检查Keycloak客户端配置 #

• 验证重定向URI匹配：在Keycloak后台testmobile realm的TestmobileUI客户端配置中，确保Valid Redirect URIs包含完全一致的http://localhost:3000/api/auth/callback/keycloak，注意协议（http/https）、端口、路径都不能有差异。
• 确认客户端权限类型：因为你使用了clientSecret，客户端的Access Type必须设为confidential，否则会导致授权流程异常。
• 核对客户端ID与Realm归属：确认TestmobileUI客户端确实属于testmobile realm，且ID大小写完全匹配（Keycloak对客户端ID大小写敏感）。

2. 简化NextAuth配置排查 #

• 暂时移除自定义回调：注释掉jwt和session回调的自定义逻辑，简化配置后测试，排除回调逻辑干扰授权流程：

  export const authOptions = {
      providers: [
        KeycloakProvider({
          clientId: "TestmobileUI",
          clientSecret: "2xxxxxxxxxxxxxxxxxxxxxxbi",
          issuer: "https://auth-jja4kcvvdq-ez.a.run.app/realms/testmobile",
        }),
      ],
      // 暂时注释回调
      // callbacks: { ... },
    };
  

• 验证Issuer地址：确保issuer末尾没有多余斜杠，NextAuth的KeycloakProvider会自动拼接OIDC端点，错误的Issuer会导致请求指向错误地址。

3. 排查请求与缓存问题 #

• 使用隐私模式测试：清空浏览器缓存或开启隐私窗口登录，排除旧的认证Cookie或会话缓存导致的自动错误提交。
• 查看Keycloak后台日志：在Keycloak后台的Events菜单中查看登录失败的详细日志，日志会明确提示错误原因（如客户端配置错误、重定向URI不匹配、用户账号状态异常等）。

4. 验证用户账号状态 #

• 在Keycloak后台testmobile realm的用户管理中，确认测试用户账号未被锁定、禁用，且密码正确；可直接在Keycloak后台测试用户登录，排除用户本身的问题。

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