如何批量将Hapi v16.4.3的reply()替换为v20.0.1的reply.response()

需求背景 #

需要将基于 Node.js v16.20.2 的 Hapi.js 应用从 v16.4.3 版本迁移至 ^20.0.1 版本。由于 Hapi v17.0.0 存在重大变更，其中 reply() 接口升级为 reply.response()，希望找到无需手动修改每个处理器的最优方案，批量替换所有处理器中的调用方式。

新旧代码示例 #

Hapi v16.4.3 原有代码 #

const addFoo = {
  description: 'add foo data',
  notes: 'add foo data',
  tags: ['api', 'FooCondition'],
  validate: {
    payload: {
      id: joi.number().required(),
    },
  },
  handler: (req, reply) => {
    return maindb.subcategorymaster.findAll({
      where: {'id': req.payload.id}
    }).then((result) => {
      reply(result);
    }).catch((DBException) => {
      reply(DBException.message);
    });
  }
};

Hapi v20.0.1 目标代码 #

const addFoo = {
  description: 'add foo data',
  notes: 'add foo data',
  tags: ['api', 'FooCondition'],
  validate: {
    payload: {
      id: joi.number().required(),
    },
  },
  handler: (req, reply) => {
    return maindb.subcategorymaster.findAll({
      where: {'id': req.payload.id}
    }).then((result) => {
      return reply.response(result);
    }).catch((DBException) => {
      return reply.response(DBException.message);
    });
  }
};

最优解决方案 #

方案1：全局正则批量替换 #

使用代码编辑器（如 VS Code）或命令行工具（如 sed）执行全局正则替换，一次性修改所有文件中的调用：

• 匹配正则：reply\(([^;)]+)\);?
• 替换内容：return reply.response($1);

说明：该正则会匹配所有 reply(xxx); 或 reply(xxx) 的写法，替换为标准的 return reply.response(xxx);，覆盖大部分业务场景。

方案2：Hapi 兼容插件（无需修改业务代码） #

编写一个 Hapi 插件，重写 reply 对象的方法，实现向下兼容，原有业务代码无需改动：

const replyCompatPlugin = {
  name: 'reply-compat',
  version: '1.0.0',
  register: async (server) => {
    server.ext('onPreHandler', (request, h) => {
      // 重写原有的 reply 方法，映射到 reply.response
      request.reply = function(data) {
        return h.response(data);
      };
      return h.continue;
    });
  }
};

// 在 Hapi 服务器初始化时注册插件
const init = async () => {
  const server = Hapi.server({ port: 3000 });
  await server.register(replyCompatPlugin);
  // 注册业务路由...
  await server.start();
};

init();

说明：通过 onPreHandler 扩展点，为每个请求的 reply 对象添加兼容方法，让原有 reply(data) 的调用自动映射到 reply.response(data)，同时满足 Hapi v20 对返回值的要求。

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