如何解决Koa框架中next() is not a function错误？

错误信息 #

TypeError: next is not a function
      at cookieParser (c:\Userxxs\x\gimt\dp-my-app\node_modules\cookie-parser\index.js:46:14)
      at dispatch (c:\Users\B748806a\gimt\dp-my-app\node_modules\koa-compose\index.js:42:32)
      at bodyParser (c:\Users\B748806a\gimt\dp-my-app\node_modules\koa-bodyparser\index.js:95:11)
      at processTicksAndRejections (internal/process/task_queues.js:93:5)

问题原因 #

1. 中间件生态不兼容：cookie-parser是Express框架的中间件，参数格式为(req, res, next)，但Koa中间件要求的格式是(ctx, next)，直接混用会导致next参数不匹配，触发错误。
2. 路由未挂载：app.js中仅定义了路由规则，但未将路由实例挂载到Koa应用上，即使解决cookie问题，自定义路由也无法生效。
3. 路由冲突：pm-js-actuator已启用/health端点，自定义的同路径路由会引发冲突。

解决方案 #

步骤1：替换为Koa兼容的Cookie处理方式 #

卸载Express的cookie-parser，安装Koa专用的中间件：

npm uninstall cookie-parser
npm install koa-cookie

修改middleware.js中的代码：

// 替换原cookie-parser的引入
const cookie = require('koa-cookie');

// 替换app.use(cookieParser())为：
app.use(cookie());

如果不需要额外解析逻辑，也可以直接删除Cookie中间件相关代码，使用Koa内置的ctx.cookies方法操作Cookie。

步骤2：挂载路由到Koa应用 #

修改app.js的init函数，添加路由挂载代码：

const init = async () => {
  try {
    routes(router);
    // 新增：挂载路由到应用，并处理OPTIONS请求
    app.use(router.routes()).use(router.allowedMethods());
  } catch (err) {
    console.error(err); // 原代码中logger未定义，先替换为console.error
  }
};

步骤3：解决路由冲突 #

修改自定义路由路径（例如改为/custom-health），或者调整Actuator配置关闭自带的health端点：

// 修改route-path.js中的路由
router.get("/custom-health", RootHeathController.handler)

步骤4：规范控制器代码（可选） #

若不需要执行后续中间件，可省略next参数，或显式调用next()：

// 方式1：省略next参数
const handler = async (ctx) => { 
  ctx.body="Hi";
}

// 方式2：若有后续中间件，调用next
const handler = async (ctx, next) => { 
  ctx.body="Hi";
  await next();
}

验证修改 #

重启应用后，访问对应路由（/health或/custom-health），错误应消失并正常返回响应内容。

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