Node.js应用离线启动触发getaddrinfo请求registry.npmjs.org报错问题

这个问题我碰到过，本质是你的Node应用在启动阶段尝试访问npm registry做依赖检查、包版本验证或者拉取远程配置，但离线状态下DNS解析失败，触发了未处理的Promise拒绝报错。而启动后拔网线能正常运行，是因为启动阶段的网络请求已经完成，后续运行不再需要访问npm源。

排查方向 #

• 先检查项目的启动脚本（package.json里的start命令），有没有隐含的联网操作，比如不小心加了npm install、npm update这类需要拉取依赖的命令
• 排查Node代码中是否有第三方库在初始化时自动检查包更新，或者显式调用npm registry的逻辑（比如使用npm-registry-client这类包）

具体解决方案 #

1. 移除启动时的不必要网络请求 #

• 如果启动脚本里包含npm install，直接删掉它。确保离线机器已经在联网环境下执行过npm install --production，把所有生产依赖都安装完成
• 对于自带更新检查的第三方库，找到对应的配置项关闭检查。比如很多工具库会提供checkForUpdates: false或者类似的参数，在初始化时传入即可跳过联网校验

2. 给Promise添加错误处理 #

即使存在无法避免的启动阶段网络请求，也要给对应的Promise加上catch处理，避免未捕获的拒绝导致报错：

// 找到发起网络请求的Promise代码，补充错误处理
checkPackageUpdates()
  .then(updates => {
    // 正常处理逻辑
  })
  .catch(err => {
    // 离线时跳过处理，打印警告即可
    if (err.message.includes('registry.npmjs.org')) {
      console.warn("离线环境，跳过npm源版本检查");
    } else {
      // 处理其他错误
      console.error("启动错误:", err);
    }
  });

还可以添加全局兜底监听，防止漏网的未处理Promise拒绝：

process.on('unhandledRejection', (reason, promise) => {
  console.log('未处理的Promise拒绝:', reason);
  // 针对npm registry的错误直接忽略
  if (reason.message?.includes('registry.npmjs.org')) {
    console.warn("离线模式下忽略npm源请求错误");
  }
});

3. 配置离线npm环境（可选） #

如果必须在启动时检查依赖，可以配置npm使用离线模式或本地缓存：

• 启动时设置环境变量强制npm离线：

  npm_config_offline=true npm start
  

• 搭建本地私有npm仓库（比如verdaccio），提前同步好所需依赖，然后把项目的npm源换成本地仓库地址：

  npm config set registry http://你的本地仓库地址:4873
  

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