Node.js新手求助：.then()方法的使用及报错问题解决

嘿，别担心，刚接触Node.js的Promise和.then()的时候踩坑太正常了！我来一步步给你捋明白怎么用它，帮你解决报错问题。

首先搞懂核心：.then()是Promise专属方法 #

你得先明白：.then()只能跟在Promise对象后面调用。如果你的函数没有返回Promise，直接用.then()肯定会报错（比如TypeError: xxx.then is not a function）——这是新手最常犯的错误之一。

Promise是Node.js里处理异步操作的标准方式，它代表一个异步操作的最终完成（或失败）及其结果值。

正确使用的步骤 #

1. 把要按顺序执行的函数改成返回Promise的形式 #

如果你原来的函数是普通的异步/同步函数，得先把它包装成返回Promise的函数。比如：

错误示例（普通函数，不能用.then()）

// 这是个普通异步函数，直接返回值的话没法用.then()
function getUserInfo() {
  // 模拟异步请求数据库
  setTimeout(() => {
    return { id: 1, name: "Alice" };
  }, 1000);
}

修正后（返回Promise）

function getUserInfo() {
  // 返回一个Promise对象，接收resolve和reject两个回调
  return new Promise((resolve, reject) => {
    setTimeout(() => {
      try {
        // 异步操作成功时，用resolve把结果传出去
        resolve({ id: 1, name: "Alice" });
      } catch (err) {
        // 失败时用reject抛出错误
        reject(new Error("获取用户信息失败"));
      }
    }, 1000);
  });
}

2. 用.then()链式调用实现顺序执行 #

当所有需要顺序执行的函数都返回Promise后，就可以用.then()链式调用，让它们按顺序执行：

// 先获取用户信息，再获取用户订单，最后打印结果
getUserInfo()
  // 第一个.then接收getUserInfo的返回值，处理后返回下一个Promise
  .then((user) => {
    console.log("获取到用户：", user);
    // 假设getUserOrders也是返回Promise的函数
    return getUserOrders(user.id);
  })
  // 第二个.then接收getUserOrders的返回值
  .then((orders) => {
    console.log("用户的订单：", orders);
    return saveOrderHistory(orders); // 同样返回Promise
  })
  // 所有步骤成功完成的回调
  .then((result) => {
    console.log("所有操作完成：", result);
  })
  // 非常关键！任何一步出错都会走到这里，统一处理错误
  .catch((error) => {
    console.error("操作出错了：", error.message);
  });

3. 同步函数也能放进链式里 #

如果某个步骤是同步操作，不用特意包装成Promise，直接返回值就行，.then()会自动把它转成Promise：

function formatUser(user) {
  // 同步函数，直接返回处理后的值
  return `用户ID：${user.id}，姓名：${user.name}`;
}

getUserInfo()
  .then((user) => {
    return formatUser(user); // 直接返回同步处理后的结果
  })
  .then((formattedUser) => {
    console.log(formattedUser); // 输出：用户ID：1，姓名：Alice
  })
  .catch((err) => console.error(err));

常见报错的原因及解决 #

1. TypeError: xxx.then is not a function

   • 原因：你调用.then()的对象不是Promise（比如普通函数、字符串、数字等）。
   • 解决：把对应的函数改成返回Promise，或者用Promise.resolve(xxx)把普通值转成Promise。

2. 链式步骤没按顺序执行

   • 原因：某个.then()里的回调函数没有返回任何值，或者返回的不是Promise，导致下一个.then()直接执行，不等异步操作完成。
   • 解决：确保每个.then()的回调都返回Promise（异步操作）或具体值（同步操作）。

3. UnhandledPromiseRejectionWarning

   • 原因：Promise的reject没有被捕获，也就是没加.catch()处理错误。
   • 解决：在链式调用的最后一定要加上.catch()，统一处理所有步骤的错误。

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