NextJS+TypeScript开发报错：Segment名称不能以错误点开头('..nextauth')

我用TypeScript开发Next.js 14.2.3应用，运行npm run dev时触发以下错误：

Error: Segment names may not start with erroneous periods ('..nextauth').

完整运行日志：

> event-management@0.1.0 dev
> next dev

  ▲ Next.js 14.2.3
  - Local:        http://localhost:3000
  - Environments: .env

 ✓ Starting...
Error: Segment names may not start with erroneous periods ('..nextauth').
    at UrlNode._insert (C:\Users\n_mac\Desktop\Coding\react\event management\event-management\node_modules\next\dist\shared\lib\router\utils\sorted-routes.js:83:23)
    at UrlNode._insert (C:\Users\n_mac\Desktop\Coding\react\event management\event-management\node_modules\next\dist\shared\lib\router\utils\sorted-routes.js:142:40)
    at UrlNode._insert (C:\Users\n_mac\Desktop\Coding\react\event management\event-management\node_modules\next\dist\shared\lib\router\utils\sorted-routes.js:142:40)
    at UrlNode.insert (C:\Users\n_mac\Desktop\Coding\react\event management\event-management\node_modules\next\dist\shared\lib\router\utils\sorted-routes.js:13:14)
    at C:\Users\n_mac\Desktop\Coding\react\event management\event-management\node_modules\next\dist\shared\lib\router\utils\sorted-routes.js:165:46
    at Array.forEach (<anonymous>)
    at getSortedRoutes (C:\Users\n_mac\Desktop\Coding\react\event management\event-management\node_modules\next\dist\shared\lib\router\utils\sorted-routes.js:165:21)
    at Watchpack.<anonymous> (C:\Users\n_mac\Desktop\Coding\react\event management\event-management\node_modules\next\dist\server\lib\router-utils\setup-dev-bundler.js:558:65)

问题原因与解决步骤 #

这个错误是Next.js路由系统检测到非法的路由段命名（以..开头），以下是排查方向：

• 检查路由文件/目录命名

  • 查看app/或pages/目录下，是否存在命名为..nextauth的文件夹或文件，比如误创建了app/..nextauth/目录，或者文件名写成..nextauth.tsx。Next.js路由段不允许以..开头，这属于非法命名。
  • 确认NextAuth.js的路由是否正确：App Router下应为app/api/auth/[...nextauth]/route.ts，Pages Router下应为pages/api/auth/[...nextauth].ts，避免路径写错导致非法段出现。

• 检查next.config.js路由配置

  • 查看配置文件中的rewrites、redirects或headers部分，是否存在包含..nextauth的路径规则，这类非法路径会被路由系统拦截。

• 清理缓存重启

  • 删除项目根目录下的.next文件夹，以及node_modules/.cache（如果存在），然后重新执行npm install和npm run dev，清除可能残留的错误路由缓存。

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