Node.js中fs.readFile执行顺序异常及全局变量初始化问题

问题根源 #

你用的是传统回调版的fs.readFile，它不返回Promise，所以加await完全无效，VS Code的报错就是这个原因。而且异步操作会被放到事件队列里，后面的同步代码（输出3、4、5、6的部分）会先跑完，导致变量还没初始化就被调用，自然顺序乱了。

解决方案 #

下面给两种靠谱的解决方式，优先选第一种：

方法1：用Promise版的fs.promises.readFile（推荐）

把配置读取逻辑放进async函数里，确保所有依赖serverAddr的代码都在初始化完成后执行：

const fs = require('fs').promises;
const path = require('path');

let serverAddr;

async function initConfig() {
  try {
    // 读取并解析配置文件
    const cfgContent = await fs.readFile(path.join(__dirname, 'cfg.json'), 'utf8');
    const cfg = JSON.parse(cfgContent);
    serverAddr = cfg.serverAddr;

    // 初始化完成后，再执行所有需要用这个变量的代码
    console.log('1:', serverAddr);
    console.log('2:', serverAddr);
    runMainLogic();
  } catch (err) {
    console.error('读取配置文件失败:', err);
    process.exit(1); // 配置读失败直接退出程序，避免后续逻辑出错
  }
}

// 把原来输出3、4、5、6的代码放到这个函数里
function runMainLogic() {
  console.log('3:', serverAddr);
  console.log('4:', serverAddr);
  console.log('5:', serverAddr);
  console.log('6:', serverAddr);
}

// 启动程序时先初始化配置
initConfig();

方法2：回调嵌套（兼容旧版Node.js）

如果必须用回调版的fs.readFile，就把所有依赖变量的代码都塞进回调函数里，确保顺序正确：

const fs = require('fs');
const path = require('path');

let serverAddr;

fs.readFile(path.join(__dirname, 'cfg.json'), 'utf8', (err, cfgContent) => {
  if (err) {
    console.error('读取配置文件失败:', err);
    process.exit(1);
  }
  const cfg = JSON.parse(cfgContent);
  serverAddr = cfg.serverAddr;

  // 所有逻辑都在这里执行，保证顺序
  console.log('1:', serverAddr);
  console.log('2:', serverAddr);
  console.log('3:', serverAddr);
  console.log('4:', serverAddr);
  console.log('5:', serverAddr);
  console.log('6:', serverAddr);
});

关键提醒 #

绝对不能在异步初始化完成前执行依赖serverAddr的代码，必须把这些逻辑放在读取完成的回调或者await之后，才能保证变量已经被正确赋值。

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