使用npm link关联模块时出现GraphQL跨模块类型错误求助

核心原因：npm link的模块隔离特性 #

npm link通过创建符号链接将依赖模块挂载到主应用，但被链接模块会被Node当作独立的模块实例加载。即便主应用和被链接模块的GraphQL版本完全一致，Node的模块解析器会因为两者的GraphQL文件路径不同（主应用node_modules/graphql vs 被链接模块node_modules/graphql），将它们识别为两个完全独立的模块实例，导致GraphQL的类型校验（如Query类型）因实例不匹配抛出错误。

可行解决办法 #

• 让被链接模块复用主应用的GraphQL实例
  进入被链接模块目录，删除自身的graphql依赖，手动创建软链接指向主应用的graphql包：

  # 切换到被链接模块目录
  cd path/to/linked-module
  # 删除自身的graphql文件夹
  rm -rf node_modules/graphql
  # 创建软链接指向主应用的graphql
  ln -s ../path/to/main-app/node_modules/graphql node_modules/graphql
  

  此方法强制被链接模块使用主应用的GraphQL实例，从根源解决多实例冲突。

• 修改Node模块解析优先级（临时方案）
  在主应用启动时通过环境变量指定模块加载优先级，强制Node优先从主应用的node_modules加载依赖：

  NODE_PATH=./node_modules node your-entry-file.js
  

  也可直接配置到主应用package.json的启动脚本中：

  "scripts": {
    "start": "NODE_PATH=./node_modules node index.js"
  }
  

• 用npm pack替代npm link（更稳定的方案）
  避开符号链接的隔离问题，将被链接模块打包为本地tar包后安装到主应用：

  # 进入被链接模块目录
  cd path/to/linked-module
  # 生成本地tar包
  npm pack
  # 回到主应用目录安装本地包
  cd ../path/to/main-app
  npm install ../path/to/linked-module/linked-module-1.0.0.tgz
  

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