Express中如何条件导入reload包？解决Heroku生产环境模块缺失报错

云上老周

2026-5-28

解决Heroku生产环境中reload模块找不到的条件导入问题

你的问题核心在于ES模块的静态import是编译时解析的——哪怕你在代码里加了环境判断，Babel编译阶段还是会尝试去查找reload模块，但Heroku已经把devDependencies里的包清掉了，所以才会抛出找不到模块的错误。

要实现生产环境完全不加载reload，可以用以下两种方案：

方案1：使用CommonJS的条件`require`

如果你的项目兼容CommonJS语法，直接把静态导入改成条件内的require即可：

// 移除顶部的import reload from 'reload'
let reload;
if (process.env.NODE_ENV !== 'production') {
  reload = require('reload');
  reload(server, app);
}

这种方式下，只有在非生产环境才会执行require('reload')，生产环境根本不会触发模块加载，自然不会报错。

方案2：使用ES模块的动态`import`

如果你的项目用的是纯ES模块，可以用动态import（运行时解析）来实现条件加载：

用async/await（需要在async函数内）

// 移除顶部的import reload from 'reload'
async function setupDevTools(server, app) {
  if (process.env.NODE_ENV !== 'production') {
    const reloadModule = await import('reload');
    reloadModule.default(server, app); // 动态import返回模块对象，需取default导出
  }
}

// 在启动服务器后调用这个函数
setupDevTools(server, app);

用Promise.then()（不需要async函数）

// 移除顶部的import reload from 'reload'
if (process.env.NODE_ENV !== 'production') {
  import('reload').then(reloadModule => {
    reloadModule.default(server, app);
  });
}

动态import是在运行时才执行的，生产环境下这个条件分支不会进入，也就不会去查找reload模块，完美避开Heroku的依赖清理问题。