NextJS api目录加中间件后遇内部服务器错误，如何排查阻塞类型？

一、判断API中间件阻塞类型 #

• 查看服务器错误日志：提取第二台服务器的Next.js运行日志，重点定位Internal Server Error对应的堆栈信息，区分是中间件代码逻辑报错（如未捕获的异常、依赖调用失败），还是服务器环境配置问题。
• 逐步隔离中间件：临时移除api目录下的中间件文件，或注释中间件核心逻辑后重新测试。如果API恢复正常，说明阻塞点在中间件；若仍返回500，问题出在服务器环境或请求转发链路。
• 对比两台服务器环境：检查Node.js版本、Next.js版本、环境变量（如第三方服务密钥、域名配置）、依赖包完整性，镜像服务器常出现环境配置不同步、依赖缺失的情况。

二、修复重写配置未生效的问题 #

• 注意路由优先级：Next.js本地api/目录的路由优先级高于next.config.js中的重写规则，所以即使配置了重写，请求仍会优先走本地中间件。若要完全跳过本地API路由，需删除本地api/目录，或给重写规则添加强制匹配条件。
• 校验重写配置语法：确保配置完整包裹在nextConfig中，示例如下：

/** @type {import('next').NextConfig} */
const nextConfig = {
  async rewrites() {
    return [
      {
        source: '/api/:path*',
        destination: 'https://subdomain.domain.com/api/:path*',
      },
    ]
  },
}

module.exports = nextConfig

• 验证重写规则生效情况：开发环境下启动项目，访问/api/[具体接口路径]，查看终端请求日志是否有转发目标域名的记录；或通过浏览器开发者工具查看请求的实际响应源，确认重写是否触发。
• 排查服务器反向代理：若使用自建服务器（如Nginx），检查是否存在拦截/api路径的代理规则，避免覆盖Next.js的重写逻辑。

内容的提问来源于stack exchange，提问作者Waleed El-Melegy