Next.js构建/部署至AWS Amplify时出现handleAuth is not a function错误求助

问题场景 #

本地运行正常的Next.js项目（已集成Auth0，配置了.env.local和.env），执行npm run build时触发以下错误：

Collecting page data  ..TypeError: (0 , n.handleAuth) is not a function
    at 65055 (C:\Webprojects\DeltoneNGCRM\deltonenextgencrm\.next\server\app\api\auth\[auth0]\route.js:1:13559)
    at t (C:\Webprojects\DeltoneNGCRM\deltonenextgencrm\.next\server\webpack-runtime.js:1:143)
    at r (C:\Webprojects\DeltoneNGCRM\deltonenextgencrm\.next\server\app\api\auth\[auth0]\route.js:1:14949)
    at <unknown> (C:\Webprojects\DeltoneNGCRM\deltonenextgencrm\.next\server\app\api\auth\[auth0]\route.js:1:14976)
    at t.X (C:\Webprojects\DeltoneNGCRM\deltonenextgencrm\.next\server\webpack-runtime.js:1:1285)
    at <unknown> (C:\Webprojects\DeltoneNGCRM\deltonenextgencrm\.next\server\app\api\auth\[auth0]\route.js:1:14962)
    at Object.<anonymous> (C:\Webprojects\DeltoneNGCRM\deltonenextgencrm\.next\server\app\api\auth\[auth0]\route.js:1:15004)

> Build error occurred
[Error: Failed to collect page data for /api/auth/[auth0]] {
  type: 'Error'
}

项目中/api/auth/[auth0]/route.js代码如下：

import { handleAuth } from "@auth0/nextjs-auth0";

export const GET = handleAuth();

已尝试：谷歌搜索相关问题、删除node_modules和package-lock.json重装依赖、确认未集成Auth0时AWS Amplify构建正常。

下一步解决方法 #

• 检查版本兼容性
  确认Next.js版本与@auth0/nextjs-auth0版本匹配：Next.js 13+ App Router需要使用@auth0/nextjs-auth0 v2.x及以上版本，v1.x仅支持Pages Router。若版本不兼容，执行升级命令：

  npm i @auth0/nextjs-auth0@latest
  

  完成后重新执行构建。

• 验证构建阶段环境变量可用性
  本地配置的环境变量可能未在构建阶段正确加载（尤其CI/CD环境如AWS Amplify）：

  • 确认所有Auth0相关环境变量（AUTH0_SECRET、AUTH0_BASE_URL、AUTH0_ISSUER_BASE_URL、AUTH0_CLIENT_ID、AUTH0_CLIENT_SECRET）已在构建环境中正确配置
  • 本地构建时，可尝试将.env.local内容复制到.env，或显式传入环境变量执行构建：

    AUTH0_SECRET=your-secret AUTH0_BASE_URL=your-url npm run build
    

• 确认App Router路由规范
  检查app/api/auth/[auth0]/route.js的目录与文件配置：

  • 目录结构无拼写错误（如[auth0]的括号格式、目录大小写）
  • 导出的GET方法正确调用handleAuth()，无语法错误

• 清除Next.js构建缓存
  除重装依赖外，清除Next.js缓存后重新构建：

  npx next clean
  npm run build
  

• 排查打包优化干扰
  部分webpack优化插件可能误删handleAuth函数，可临时禁用优化测试：
  在next.config.js中添加：

  module.exports = {
    webpack: (config) => {
      config.optimization.minimize = false;
      return config;
    }
  };
  

  若构建恢复正常，再逐步调整优化配置。

• 创建最小复现项目验证
  新建空白Next.js项目，仅集成Auth0基础配置并执行构建。若该项目构建正常，说明原项目存在依赖或配置冲突，需逐步排查其他插件、自定义webpack配置等内容。

内容的提问来源于stack exchange，提问作者Sajith Jayaratne