更新package.json后项目出现Error UnknownAction错误求助

安全阿岳

2026-7-1

解决Error UnknownAction: Cannot parse action at /api/auth/session错误

针对你更新package.json后出现的这个错误，结合给出的代码片段，提供几个排查和修复方向：

补全认证提供者配置
你代码里导入了Keycloak提供者，但providers数组是空的。qwik-auth依赖的Auth.js需要至少配置一个认证提供者才能正常初始化会话相关的action接口。补全Keycloak配置：
```
providers: [
  Keycloak({
    clientId: env.get("KEYCLOAK_CLIENT_ID"),
    clientSecret: env.get("KEYCLOAK_CLIENT_SECRET"),
    issuer: env.get("KEYCLOAK_ISSUER"),
  })
] as Provider[],
```
空提供者列表会导致/auth/session这类核心接口无法被正确注册，进而触发UnknownAction错误。
检查依赖版本兼容性
更新package.json后，可能@builder.io/qwik-auth和@auth/core的版本不匹配。qwik-auth对@auth/core有严格的版本依赖要求，版本不兼容会导致内部逻辑异常。查看qwik-auth的版本说明，调整package.json中相关依赖的版本，然后重新执行依赖安装命令（npm install或pnpm install）。
验证环境变量有效性
确保AUTH_SECRET环境变量已正确配置且能被env.get("AUTH_SECRET")获取到。空的secret会导致认证流程初始化失败，间接引发action解析错误。可以临时添加日志打印确认变量值是否存在。
排查路由冲突
检查项目中是否有自定义路由覆盖了/api/auth/*路径，导致请求无法到达qwik-auth的内置处理逻辑。确保qwik-auth的onRequest中间件已正确注册到全局路由中。