Express.js调用API时的异步问题及最佳实践咨询

我非常喜欢使用node.js进行编程，尤其偏爱express.js。今天我遇到了典型的异步问题，虽然查阅了大量相关资料及可能的解决方案，但想了解在Express.js中处理这类问题的最佳实践是什么？我尝试使用回调方案，但并未奏效。我承认自己在这方面还是新手，希望能得到社区的可行解决方案。

我认为以下代码的问题在于，调用getUserDataFromSpotify(cookieAccessToken)是异步操作，后续代码无法在该函数返回值时及时获取inputData变量的id：

app.get('/landingpage', function(req, res){ 
  var cookieAccessToken = req.cookies.access_token; 
  var inputData = getUserDataFromSpotify(cookieAccessToken); 
  res.render('UserProfile', {display_name: inputData.id}); 
}); 

function getUserDataFromSpotify(userToken){ 
  var options = { 
    url: 'https://api.spotify.com/v1/me', 
    headers: { 'Authorization': 'Bearer ' + userToken }, 
    json: true 
  }; 
  request.get(options, function(error, response, body) { 
    console.log(response.statusCode); 
    console.log(body); 
    return body; 
  }); 
}

嘿，我完全懂你现在踩的这个异步坑——刚接触Node.js和Express的时候，这种“代码顺序和执行顺序不一样”的问题真的特别容易让人懵！你的判断完全正确：getUserDataFromSpotify里的request.get是异步操作，它不会立刻返回结果，而你同步去赋值inputData的时候，这个函数其实还没完成API调用，所以inputData是undefined，自然拿不到id。

下面给你几种实用的解决方案，从修正你的回调尝试，到更现代的写法，一步步来：

1. 修正你的回调方案（让它真正生效） #

你之前用回调没成功，是因为getUserDataFromSpotify没有把异步操作的结果传递给路由里的逻辑。我们需要让这个函数接受一个回调参数，在API请求完成后调用它：

app.get('/landingpage', function(req, res){ 
  var cookieAccessToken = req.cookies.access_token; 
  // 把回调传进去，拿到结果后再渲染页面
  getUserDataFromSpotify(cookieAccessToken, function(error, userData) {
    if (error) {
      // 处理错误，比如返回500或者错误页面
      return res.status(500).send('获取用户数据失败');
    }
    res.render('UserProfile', {display_name: userData.id}); 
  });
}); 

function getUserDataFromSpotify(userToken, callback){ 
  var options = { 
    url: 'https://api.spotify.com/v1/me', 
    headers: { 'Authorization': 'Bearer ' + userToken }, 
    json: true 
  }; 
  request.get(options, function(error, response, body) { 
    if (error) {
      // 把错误传给回调
      return callback(error);
    }
    // 检查状态码，比如401、403这些也要处理
    if (response.statusCode !== 200) {
      return callback(new Error(`API请求失败，状态码：${response.statusCode}`));
    }
    console.log(response.statusCode); 
    console.log(body); 
    // 把成功的结果传给回调
    callback(null, body);
  }); 
}

2. 使用Promise（更优雅的异步处理） #

回调嵌套多了容易陷入“回调地狱”，Promise能帮我们把异步操作链式起来。你可以用request-promise（request库的Promise版本），或者自己把request.get封装成Promise：

方案2.1：用request-promise库 #

先安装依赖：npm install request-promise

然后修改代码：

const rp = require('request-promise');

app.get('/landingpage', function(req, res){ 
  var cookieAccessToken = req.cookies.access_token; 
  getUserDataFromSpotify(cookieAccessToken)
    .then(userData => {
      res.render('UserProfile', {display_name: userData.id}); 
    })
    .catch(error => {
      res.status(500).send('获取用户数据失败：' + error.message);
    });
}); 

function getUserDataFromSpotify(userToken){ 
  var options = { 
    url: 'https://api.spotify.com/v1/me', 
    headers: { 'Authorization': 'Bearer ' + userToken }, 
    json: true,
    resolveWithFullResponse: false // 只返回body
  }; 
  // 返回Promise
  return rp.get(options);
}

方案2.2：手动封装Promise #

如果不想加新依赖，可以自己封装：

app.get('/landingpage', function(req, res){ 
  var cookieAccessToken = req.cookies.access_token; 
  getUserDataFromSpotify(cookieAccessToken)
    .then(userData => {
      res.render('UserProfile', {display_name: userData.id}); 
    })
    .catch(error => {
      res.status(500).send('获取用户数据失败：' + error.message);
    });
}); 

function getUserDataFromSpotify(userToken){ 
  return new Promise((resolve, reject) => {
    var options = { 
      url: 'https://api.spotify.com/v1/me', 
      headers: { 'Authorization': 'Bearer ' + userToken }, 
      json: true 
    }; 
    request.get(options, function(error, response, body) { 
      if (error) {
        return reject(error);
      }
      if (response.statusCode !== 200) {
        return reject(new Error(`API请求失败，状态码：${response.statusCode}`));
      }
      resolve(body);
    }); 
  });
}

3. Async/Await（最直观的写法，新手友好） #

ES2017的async/await语法让异步代码看起来像同步代码，可读性最强，也是现在Express里的最佳实践之一。只需要把路由处理函数改成async函数，然后用await等待Promise的结果：

// 如果用request-promise，或者自己封装的Promise都可以用这个写法
app.get('/landingpage', async function(req, res){ 
  try {
    var cookieAccessToken = req.cookies.access_token; 
    var userData = await getUserDataFromSpotify(cookieAccessToken);
    res.render('UserProfile', {display_name: userData.id}); 
  } catch (error) {
    res.status(500).send('获取用户数据失败：' + error.message);
  }
}); 

// 这里用前面封装好的返回Promise的getUserDataFromSpotify函数就可以
function getUserDataFromSpotify(userToken){ 
  return new Promise((resolve, reject) => {
    var options = { 
      url: 'https://api.spotify.com/v1/me', 
      headers: { 'Authorization': 'Bearer ' + userToken }, 
      json: true 
    }; 
    request.get(options, function(error, response, body) { 
      if (error) {
        return reject(error);
      }
      if (response.statusCode !== 200) {
        return reject(new Error(`API请求失败，状态码：${response.statusCode}`));
      }
      resolve(body);
    }); 
  });
}

最后说说Express里异步操作的最佳实践 #

• 优先用Async/Await：可读性最好，代码逻辑和同步代码一致，新手更容易理解和维护。
• 一定要处理错误：不管用回调还是Promise/await，都要捕获错误，避免Express因为未处理的异常崩溃。
• 避免回调嵌套：如果有多个异步操作，用Promise链式调用或者await依次处理，别写成层层嵌套的回调。
• 考虑用现代HTTP库：request库已经停止维护了，推荐用axios、node-fetch这些支持Promise的现代库，写起来更顺手。

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