使用Hapi 17的NodeJS应用报错：handler未返回值/承诺或抛错

嘿，这个问题我太熟悉了！Hapi 17及以后的版本对路由handler的要求特别严格——它必须明确给一个“完成信号”：要么返回一个值，要么返回一个Promise，要么主动抛出错误，不然就会弹出你看到的这个报错。结合你调用地图图片Web服务的场景，大概率是异步请求的处理方式踩坑了，咱们来一步步解决：

常见错误场景&修复方案 #

1. 用了回调式的HTTP请求，外层handler没返回Promise #

很多老的HTTP请求库（比如原生http模块、旧版request）是回调风格的，如果你直接在handler里写回调，外层函数根本没返回任何东西，Hapi自然会报错。比如你可能写了类似这样的代码：

server.route({
  method: 'GET',
  path: '/map',
  handler: (request, h) => {
    // 调用地图服务的回调式请求
    getMapImage((err, imageData) => {
      if (err) console.log(err);
      return h.response(imageData).type('image/png');
    });
    // 这里！外层handler没有返回任何内容！
  }
});

修复办法：把回调包装成Promise，或者换成支持Promise的HTTP库（比如axios、node-fetch）。下面是两种可行的写法：

写法一：用Promise包装回调

server.route({
  method: 'GET',
  path: '/map',
  handler: async (request, h) => {
    try {
      // 把回调逻辑包进Promise里
      const imageData = await new Promise((resolve, reject) => {
        getMapImage((err, data) => {
          if (err) return reject(err);
          resolve(data);
        });
      });
      return h.response(imageData).type('image/png');
    } catch (err) {
      // 主动抛出错误，让Hapi处理异常
      throw err;
    }
  }
});

写法二：用支持Promise的请求库（推荐）

比如用axios请求地图服务：

const axios = require('axios');

server.route({
  method: 'GET',
  path: '/map',
  handler: async (request, h) => {
    // 注意设置responseType为arraybuffer，因为是图片二进制数据
    const response = await axios.get('你的地图服务URL', { responseType: 'arraybuffer' });
    return h.response(response.data).type('image/png');
  }
});

2. 忘记在handler外层返回结果 #

有时候你可能把return写在了回调或者内部函数里，但外层的handler函数根本没返回任何值。比如：

// 错误示例：return在回调里，外层没返回
handler: (request, h) => {
  fetchMapImage().then(image => {
    return h.response(image); // 这个return只属于then回调，不属于handler
  });
}

修复办法：确保外层handler返回Promise或者直接返回结果。上面的代码可以改成async/await风格，或者直接返回fetch的Promise：

// 正确写法：返回Promise
handler: (request, h) => {
  return fetchMapImage().then(image => {
    return h.response(image).type('image/png');
  }).catch(err => {
    throw err; // 错误也要抛出
  });
}

3. 错误处理不规范，没主动抛出错误 #

如果调用地图服务出错了，你只是用console.log打了错误，但没主动抛出，Hapi会认为handler“成功执行但没返回值”，照样报错。

修复办法：所有异常都要通过throw抛出去，或者在Promise的reject里传递错误，让Hapi能捕获到并处理。

核心总结 #

Hapi 17+的handler本质上要求是一个“可完成的函数”——同步函数要返回值，异步函数要返回Promise（或者用async/await语法糖），出错时必须主动抛出错误。你的问题核心就是异步请求的处理没满足这个要求，调整成上面的写法应该就能解决啦！

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