Next.js构建时Next-Auth出现UnknownAction错误，求解决方案

问题概述 #

构建Next.js应用后遇到Next-Auth（Auth.js）的UnknownAction: Cannot parse action at /session错误，开发模式运行正常；移除NEXTAUTH_URL会触发“Untrusted Host!”错误。

解决步骤 #

• 检查Next-Auth路由配置
  确认项目中存在正确的Auth路由文件：

  • App Router项目需确保有app/api/auth/[...nextauth]/route.js
  • Pages Router项目需确保有pages/api/auth/[...nextauth].js
    路由文件名必须是[...nextauth]，不能省略三个点，且文件内的NextAuth配置需正确引入AUTH_SECRET、DATABASE_URL等环境变量。

• 修正环境变量配置

  • 生产环境下NEXTAUTH_URL不能硬编码为http://localhost:3000，需替换为实际部署的域名（如https://your-domain.com）；开发环境可保留localhost配置。
  • 尝试将NEXTAUTH_URL替换为Auth.js推荐的AUTH_URL变量，避免旧变量名的兼容性问题。

• 修正客户端session请求路径
  错误日志中提到的/session路径是错误的，Next-Auth的session接口正确路径为/api/auth/session。检查项目中是否有手动请求/session的代码，改为使用useSession()（客户端组件）或getServerSession()（服务器组件/API路由）来获取会话信息。

• 清理构建缓存
  删除项目根目录下的.next文件夹和node_modules/.cache目录，重新执行npm run build和npm start，避免缓存导致的路由解析异常。

• 检查版本兼容性
  确保Next.js与Auth.js版本匹配（Next.js 13+需搭配Auth.js v4及以上版本）。查看package.json中的依赖版本，更新next-auth（或@auth/nextjs）到最新稳定版后重新构建。

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