Koa模块导入异常：子模块导出实例在主模块instanceof检测为false

哦，这个问题我之前踩过坑！核心原因是你的项目里加载了两个不同的Koa构造函数实例，导致instanceof判断失效了——虽然子应用里的app看起来和主文件里的Koa实例结构完全一致，但它们本质上是由不同的Koa构造函数创建的，所以app1 instanceof Koa会返回false。

为什么会出现这个问题？ #

这通常是因为你的子应用（./apps/app1）目录下自己安装了Koa，也就是./apps/app1/node_modules/koa存在。当子应用require('koa')时，Node.js会优先加载当前目录下的Koa，而主文件server.js加载的是根目录node_modules/koa里的版本。这两个Koa是完全独立的模块，它们的构造函数不是同一个对象，自然instanceof就不成立了。

你可以快速验证这一点：

• 在server.js里添加：

  console.log('主文件Koa路径:', require.resolve('koa'));
  

• 在./apps/app1/index.js里添加：

  console.log('子应用Koa路径:', require.resolve('koa'));
  

如果打印出来的路径不一样，就实锤了这个问题。

解决步骤 #

1. 清理子应用的本地依赖 #

删掉子应用目录下的node_modules文件夹和package-lock.json（如果有的话），确保子应用不会单独加载自己的Koa版本。

2. 统一根目录依赖 #

确保Koa只安装在项目根目录的node_modules里：

# 进入根目录执行
npm install koa

子应用的package.json里如果有Koa的依赖，把它移到根目录的package.json中，子应用不需要单独声明Koa依赖（如果需要开发依赖的话，可以设为peerDependency）。

3. 验证修复效果 #

重新启动项目，你会发现console.log(app1 instanceof Koa)现在会返回true，composer函数也能正常获取到app1.middleware了。

额外的兼容优化（可选） #

如果担心以后再出现类似依赖不一致的问题，可以修改composer函数，绕过instanceof判断，直接检查middleware属性是否存在：

function composer(app) {
  // 直接检查是否有middleware数组，而不是依赖instanceof
  const middleware = Array.isArray(app.middleware) ? app.middleware : app;
  return compose(middleware);
}

这样即使不小心出现多Koa实例的情况，代码也能正常运行。

内容的提问来源于stack exchange，提问作者Nicolas Le Thierry d'Ennequin