如何打造可复用的后端错误消息转换函数？

核心优化思路：用配置化规则替代硬编码 #

把需要替换的规则统一维护在配置结构中，后续新增或修改规则只需更新配置，无需改动函数逻辑，扩展性更强。

具体实现方案 #

• 定义替换规则集合：用对象或数组存储所有替换规则，可支持精准文本匹配或正则匹配（适配带动态参数的错误消息）。
• 批量替换逻辑：遍历规则集合，对输入的错误消息依次执行替换操作。
• 完善边界处理：处理null、空字符串等异常输入，避免报错；未匹配到任何规则时直接返回原始消息。

代码示例 #

基础版本（精准文本匹配）

const errorMessageConvertor = (errorMessage) => {
  if (!errorMessage) return errorMessage;
  
  // 替换规则表：可按需扩展新增
  const replaceRules = {
    "payment_amount": "payment amount",
    "invalid_user_id": "invalid user ID",
    "insufficient_balance": "insufficient account balance"
  };

  let convertedMsg = String(errorMessage);
  // 遍历所有规则执行替换
  Object.entries(replaceRules).forEach(([original, target]) => {
    convertedMsg = convertedMsg.replaceAll(original, target);
  });

  return convertedMsg;
};

进阶版本（支持正则匹配，适配动态参数）

如果后端错误消息包含动态内容（比如金额、订单号），用正则可以更灵活匹配：

const errorMessageConvertor = (errorMessage) => {
  if (!errorMessage) return errorMessage;
  
  const replaceRules = [
    // 全局匹配下划线分隔的字段名，替换为空格分隔
    { regex: /(\w+)_(\w+)/g, replace: "$1 $2" },
    // 特定错误场景的自定义替换
    { regex: /Invalid token/g, replace: "登录凭证已失效，请重新登录" },
    { regex: /Order (\d+) not found/g, replace: "订单 $1 不存在" }
  ];

  let convertedMsg = String(errorMessage);
  replaceRules.forEach(({ regex, replace }) => {
    convertedMsg = convertedMsg.replace(regex, replace);
  });

  return convertedMsg;
};

额外实用建议 #

• 规则抽离维护：把替换规则放到单独的配置文件（比如errorReplaceRules.js），方便团队协作维护和多环境复用。
• 支持动态规则传入：给函数新增参数，允许外部传入自定义规则表，适配临时或特殊业务场景。
• 添加转换日志：对转换前后的消息做日志记录，方便排查未覆盖的错误消息，持续优化规则库。

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