Next Auth配置Base Path与Keycloak时回调解析失败求助

应用基础路径为/builder，运行后出现Cannot parse action at /api/auth/callback/keycloak错误，已修改SessionProvider的basePath但未解决，可从以下几点排查：

• 修正Keycloak客户端回调配置
  登录Keycloak控制台，找到ID为builder的客户端，将Valid Redirect URIs和Web Origins更新为带基础路径的完整地址，例如：

  http://localhost:4200/builder/api/auth/callback/keycloak
  

  确保不要遗漏/builder前缀，否则Keycloak返回的回调地址会与应用实际路径不匹配。

• 启用并配置正确的AUTH_URL环境变量
  当前AUTH_URL处于注释状态，取消注释并修改为包含基础路径的地址：

  AUTH_URL=http://localhost:4200/builder/api/auth
  

  该变量用于告知认证服务回调的基础路径，未配置时服务会默认使用根路径生成回调地址，导致路径解析失败。

• 确认SessionProvider的basePath配置生效
  检查SessionProvider的basePath是否在认证初始化阶段正确设置为/builder，而非仅在后续逻辑中修改。例如在初始化认证模块时，需将basePath参数明确传入配置，确保认证服务生成的所有路由都自动带上该前缀。

• 验证应用全局基础路径配置
  确保应用本身的路由基础路径已正确设置为/builder：

  • 若为前端应用（如Angular），需在构建配置或路由模块中设置baseHref="/builder/"；
  • 若为后端服务，需将所有API路由挂载在/builder路径下，避免回调请求被路由到不存在的地址。

• 开启认证日志定位细节
  开启认证相关的debug级日志，查看生成的回调URL具体内容，确认是否包含/builder前缀。通过日志可以直接定位路径拼接过程中是否存在遗漏或错误。

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