NodeJS中"Cannot access 'server' before initialization"错误排查：生产代码本地升级后异常

这问题真的有点让人挠头——代码在7台服务器的21个实例都跑好好的，本地升级个Node和系统就出问题了，而且代码完全没改对吧？我来帮你理清楚前因后果，再给你几个靠谱的解决方案。

为什么这段代码之前（包括生产环境升级到Node15）能正常运行？ #

核心是变量提升+函数声明提升+实际调用时机的组合作用：

• shutdown是函数声明，会被JavaScript引擎自动提升到整个作用域的最顶部；
• 不管server是用var还是const声明，变量本身都会被提升——var声明的变量初始值为undefined，const/let则会进入暂时性死区；
• 但在生产环境和旧Node版本的本地环境中，shutdown从来没有在server完成初始化之前被调用过。所有触发shutdown的事件（比如SIGTERM信号、shutdown消息、服务器运行时的错误）都是在server成功启动并赋值之后才发生的，这时候server已经是有效的HTTPS服务器实例，所以函数里访问server完全没问题。

为什么本地升级Node12和macOS10.14后会报错？ #

最可能的原因有两个：

1. 本地启动时触发了提前调用shutdown的异常：
   看你的代码开头直接用了wslog和wsconfig，但没有看到对应的require语句——如果本地环境中这两个模块没有正确加载（比如路径错误、依赖丢失，或者升级系统后权限问题导致文件读不到），启动时会直接抛出ReferenceError，触发uncaughtException事件，进而调用shutdown。这时候server还没完成初始化，就会出现"Cannot access 'server' before initialization"的错误（如果是const/let声明server），或者"Cannot read property 'on' of undefined"（如果是var）。
   生产环境中这些依赖肯定是配置正确的，所以不会出现启动时的异常，shutdown只会在服务运行后被调用。

2. Node12对严格模式下的变量访问检测更严格：
   虽然理论上只要shutdown在server赋值后调用就没问题，但Node12可能对暂时性死区的检测更敏锐，或者某些边缘情况的处理和Node10不同，但这个可能性比第一个小得多。

怎么解决这个问题？ #

方案1：给shutdown加前置检查，避免访问未初始化的server #

修改shutdown函数，先判断server是否存在，如果不存在就直接退出，避免报错：

function shutdown() {
  if (!server) {
    wslog?.info(`${wsconfig?.appName || '未知应用'} 服务器未初始化，直接退出。`);
    process.exit(0);
  }
  httpStatus = 503; // 服务不可用
  wslog.info(`${wsconfig.appName} 当前httpStatus为${httpStatus} - 正在停止服务器...`);
  server.on('close', function () {
    wslog.info(`${wsconfig.appName} HTTP服务器已停止，即将退出进程。`);
    process.exit(0)
  });
  server.stop();
}

这里用了可选链操作符?.，避免wslog或wsconfig未定义时又抛出新的异常。

方案2：把shutdown函数移到server初始化之后定义 #

既然问题是shutdown在server之前定义，那直接把shutdown的定义移到server创建之后，这样即使有提前调用的情况，至少server已经被提升并赋值（哪怕是undefined），而且逻辑上更合理——停止服务的函数应该在服务创建之后定义：

// 先初始化server
var server = https.createServer(serverOptions, global.app)
  .listen(wsconfig.port, function () {
    wslog.info(`正在监听端口 ${wsconfig.port}。`);
  });

// 再定义shutdown函数
function shutdown() {
  httpStatus = 503;
  wslog.info(`${wsconfig.appName} 当前httpStatus为${httpStatus} - 正在停止服务器...`);
  server.on('close', function () {
    wslog.info(`${wsconfig.appName} HTTP服务器已停止，即将退出进程。`);
    process.exit(0)
  });
  server.stop();
}

// 最后绑定事件处理器（确保shutdown已经定义）
process.on('uncaughtException', err => {
  wslog.error(`Uncaught Exception: ${err} ${err.stack}`);
  shutdown();
});
// 其他事件绑定同理...

方案3：修复本地环境的启动异常 #

检查本地环境中wslog、wsconfig的加载情况：

• 确认对应的文件存在，路径正确；
• 检查文件权限，升级macOS后可能权限发生变化；
• 确认所有依赖都已正确安装（比如执行npm install）；
• 启动前先打印wslog和wsconfig，看是否能正常访问。

只要解决了启动时的异常，shutdown就只会在服务运行后被调用，和生产环境一致，问题自然就消失了。

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