Next.js集成NextAuth v5报错：Catch-all需为URL最后部分求助

算力阿峰

2026-6-23

解决Next.js 14集成NextAuth v5的「Catch-all must be the last part of the URL」错误

问题原因

这个错误的核心是路由文件的路径和命名完全不符合NextAuth v5的规则：

NextAuth v5默认适配Next.js 14的App Router，正确路由文件路径为app/api/auth/[...nextauth]/route.js，你却错误放置在pages目录下。
pages目录的API路由不需要用route.js命名，且你写的路径auth[...nextauth]缺少斜杠，应为auth/[...nextauth]——但这本身就不是v5的正确用法，v5已放弃Pages Router的这种写法。

修复步骤

删除错误文件
直接删除pages/api/auth[...nextauth]/route.js，该文件完全不符合v5的路由规范。

创建正确的App Router路由
在项目根目录新建路径app/api/auth/[...nextauth]/，并在该文件夹内创建route.js，示例代码如下：

import NextAuth from "next-auth";
import CredentialsProvider from "next-auth/providers/credentials";

export const { handlers, auth, signIn, signOut } = NextAuth({
  providers: [
    CredentialsProvider({
      name: "Credentials",
      credentials: {
        email: { label: "邮箱", type: "email" },
        password: { label: "密码", type: "password" }
      },
      async authorize(credentials) {
        // 替换为你的实际用户验证逻辑，比如查询数据库
        const user = { id: "1", name: "测试用户", email: "test@example.com" };
        return user ? user : null;
      }
    })
  ],
  session: { strategy: "jwt" },
  secret: process.env.NEXTAUTH_SECRET,
});