TypeScript中catch捕获unknown类型错误的修复方案咨询

问题场景 #

我每次数据库查询都会返回包含message和success两个属性的对象，为此定义了以下IDBReturn接口：

export interface IDBReturn {
  message: string;
  success: boolean;
}

随后将其作为createTenant函数的返回类型：

export const createTenant = async ({
  name,
  city,
  street,
  zipcode,
  category,
  company,
  domain,
  code,
  packet
}: ICreateTenant): Promise<IDBReturn> => {
  try {
    await pg.none('INSERT INTO tenants (name, city, street, zipcode, category, company, domain, code, packet) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9);',
      [name, city, street, zipcode, category, company, domain, code, packet]);
    return {
      message: 'Tenant erfolgreich erstellt.',
      success: true
    };
  } catch(e) {
    if(e instanceof Error) {
      return {
        message: e.message,
        success: false
      }
    } else {
      return {
        message: e,
        success: false
      }
    }
  }
};

在catch分支的else语句中，出现错误：Type 'unknown' is not assignable to type 'string'。作为TypeScript新手，我想了解其他可能的错误类型以及该错误的最佳修复方法。

错误原因 #

在TypeScript 4.4及以上版本中，catch语句捕获的异常参数e默认类型是unknown。这个设计是为了强制开发者明确处理所有可能的异常类型，避免因假设异常都是Error对象而导致的类型安全问题。你的IDBReturn接口要求message必须是string类型，但else分支中直接将unknown类型的e赋值给它，因此触发了类型错误。

可能遇到的其他异常类型 #

代码中抛出的异常并不局限于标准Error对象，还可能是以下类型：

• 原始值：直接抛出的字符串（如throw '插入失败'）、数字（如throw 500），甚至null或undefined
• 自定义错误实例：继承自Error类的自定义错误（如class DBInsertError extends Error {}）
• 任意对象：不继承Error的普通对象（如throw { code: 'DB_ERROR', detail: '重复主键' }）

最佳修复方案 #

方案1：统一将异常转为字符串（推荐） #

不管捕获到的异常是什么类型，都通过String()方法强制转为字符串，确保message符合string类型要求：

catch(e) {
  if(e instanceof Error) {
    return {
      message: e.message,
      success: false
    };
  } else {
    // 处理所有非Error类型的异常
    return {
      message: String(e),
      success: false
    };
  }
}

这种方法简单通用，能覆盖所有可能的异常场景，同时保持类型安全。

方案2：封装通用错误处理函数（适合大型项目） #

如果项目中有大量重复的错误逻辑，可以封装一个工具函数统一处理异常消息：

// 通用错误消息处理函数
const getErrorMsg = (e: unknown): string => {
  if (e instanceof Error) return e.message;
  // 处理其他类型的异常
  return typeof e === 'string' ? e : JSON.stringify(e);
};

// 在catch分支中使用
catch(e) {
  return {
    message: getErrorMsg(e),
    success: false
  };
}

这种方式提升了代码复用性，也能更灵活地处理不同类型的异常。

方案3：显式指定catch参数类型（不推荐） #

如果你能明确代码只会抛出特定类型的异常，可以给e指定更宽泛的类型，但这会损失部分类型安全，仅适合临时调试：

// 仅在确定异常范围时使用
catch(e: Error | string | number) {
  if(e instanceof Error) {
    return { message: e.message, success: false };
  } else {
    return { message: String(e), success: false };
  }
}

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