Next.js 15部署NextAuth v5报错：handlers不是合法路由导出字段

问题描述 #

部署集成NextAuth v5（beta.27）的Next.js 15.3.2应用到Vercel时，触发编译错误：

编译失败。
src/app/api/auth/[...nextauth]/route.ts
类型错误：路由“src/app/api/auth/[...nextauth]/route.ts”不符合Next.js路由的要求类型。
"handlers"不是有效的路由导出字段。

认证系统在开发环境运行正常，但生产部署报错。

环境信息 #

• Next.js: 15.3.2
• next-auth: 5.0.0-beta.27
• @auth/core: 0.39.0

原始路由代码 #

// src/app/api/auth/[...nextauth]/route.ts
import NextAuth from "next-auth";
import GoogleProvider from "next-auth/providers/google";
import { randomUUID } from "crypto";
import prisma from "@/lib/prisma";
import { authConstants } from "@/lib/constants/auth";

// 使用v5方式创建认证处理器
export const { handlers, auth, signIn, signOut } = NextAuth({
  providers: [
    GoogleProvider({
      clientId: process.env.GOOGLE_CLIENT_ID!,
      clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
      authorization: {
        params: {
          prompt: "select_account",
        },
      },
    }),
  ],
  callbacks: {
    async signIn({ user, account }) {
      if (
        account?.provider === authConstants.AUTH.PROVIDERS.GOOGLE &&
        user.email
      ) {
        try {
          const existingUser = await prisma.user.findUnique({
            where: { email: user.email },
          });
          // 检查用户是否存在
          if (!existingUser) {
            // 若不存在则创建新用户
            await prisma.user.create({
              data: {
                name: user.name?.split(" ")[0] || "",
                last_name: user.name?.split(" ").slice(1).join(" ") || "",
                email: user.email,
                password_hash: `oauth_${randomUUID()}`,
              },
            });
          }
          return true;
        } catch (error) {
          console.error("Error in Google signin:", error);
          return false;
        }
      }
      return true;
    },
  },
});

export const GET = handlers.GET;
export const POST = handlers.POST;

已尝试的解决方案 #

• 将配置分离到独立的authOptions.ts文件，路由文件改用const handler = NextAuth(authOptions); export { handler as GET, handler as POST };
• 创建独立的auth.ts文件导出GET/POST，路由文件直接导入
• 移除authConfig的export关键字
• 确认Vercel环境变量配置正确

以上方案均未解决部署编译错误。

解决方案 #

问题核心：Next.js App Router的路由文件不允许导出非标准路由字段（比如handlers），即使后续导出了GET/POST，只要同时导出handlers就会触发严格的类型检查错误（开发环境类型校验宽松，生产构建会严格执行）。

正确实现步骤 #

1. 分离Auth配置与路由逻辑

创建src/auth.ts文件，存放完整的NextAuth配置并导出所需方法：

// src/auth.ts
import NextAuth from "next-auth";
import GoogleProvider from "next-auth/providers/google";
import { randomUUID } from "crypto";
import prisma from "@/lib/prisma";
import { authConstants } from "@/lib/constants/auth";

export const { auth, signIn, signOut, handlers } = NextAuth({
  providers: [
    GoogleProvider({
      clientId: process.env.GOOGLE_CLIENT_ID!,
      clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
      authorization: {
        params: {
          prompt: "select_account",
        },
      },
    }),
  ],
  callbacks: {
    async signIn({ user, account }) {
      if (
        account?.provider === authConstants.AUTH.PROVIDERS.GOOGLE &&
        user.email
      ) {
        try {
          const existingUser = await prisma.user.findUnique({
            where: { email: user.email },
          });
          if (!existingUser) {
            await prisma.user.create({
              data: {
                name: user.name?.split(" ")[0] || "",
                last_name: user.name?.split(" ").slice(1).join(" ") || "",
                email: user.email,
                password_hash: `oauth_${randomUUID()}`,
              },
            });
          }
          return true;
        } catch (error) {
          console.error("Error in Google signin:", error);
          return false;
        }
      }
      return true;
    },
  },
});

2. 路由文件仅导出标准HTTP方法

修改src/app/api/auth/[...nextauth]/route.ts，只导入并导出路由所需的GET和POST方法，避免导出任何非标准字段：

// src/app/api/auth/[...nextauth]/route.ts
export { GET, POST } from "@/auth";

关键说明 #

• Next.js App Router路由文件仅允许导出**标准HTTP方法（GET/POST/PUT等）**和Next.js特定配置项（如dynamic、revalidate），额外导出会触发类型校验失败。
• auth、signIn、signOut等方法可直接从src/auth.ts导入到其他组件/API中使用，无需在路由文件中导出。
• 该方案同时兼容开发和生产环境，可通过Vercel的严格编译校验。

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