Node.js模块调用返回Promise却获undefined问题排查

你的readHistory函数存在两个核心问题：

1. async函数未返回有效Promise：虽然声明了async，但内部使用回调式的fs.readFile，没有将异步操作包装成Promise，也没有返回任何值，导致async函数默认返回一个状态为resolved、值为undefined的Promise。
2. 参数传递逻辑错误：试图通过修改函数参数history传递返回值，但JavaScript基本类型是值传递，修改参数不会影响外部变量，这种方式根本无法把文件内容传递出去。

推荐使用Node.js内置的fs.promises模块（异步Promise化的文件操作API），替代回调式的fs.readFile，同时让async函数返回文件内容的Promise。

修正后的readHistory.js模块 #

const fs = require('fs').promises; // 使用Promise化的fs API

async function readHistory() {
  try {
    const data = await fs.readFile("history_file.txt");
    return data.toString(); // 返回文件内容的字符串形式
  } catch (err) {
    console.error('读取文件失败:', err);
    throw err; // 抛出错误，让调用方可以捕获处理
  }
}

module.exports = { readHistory };

正确的调用方式 #

方式1：使用.then()链式调用 #

const { readHistory } = require("./readHistory");

readHistory()
  .then(value => {
    console.log("Other context: " + value); // 输出文件内容
  })
  .catch(err => {
    // 处理读取错误
    console.error(err);
  });

方式2：使用await（需在async函数中执行） #

const { readHistory } = require("./readHistory");

// 必须在async函数内使用await
async function getHistory() {
  try {
    const contextClues = await readHistory();
    console.log("Other context: " + contextClues); // 输出文件内容
  } catch (err) {
    console.error(err);
  }
}

getHistory();

• 原代码中直接调用readHistory()是多余的，导出模块前不需要执行这个函数，删除即可。
• 如果一定要用回调式的fs.readFile，需要手动包装成Promise，示例如下：

const fs = require('fs');

function readHistory() {
  return new Promise((resolve, reject) => {
    fs.readFile("history_file.txt", (err, data) => {
      if (err) {
        reject(err);
        return;
      }
      resolve(data.toString());
    });
  });
}

module.exports = { readHistory };

这种写法同样可以让调用方用await或.then()获取结果，但不如fs.promises简洁。

内容的提问来源于stack exchange，提问作者Z-Man Jones