TypeScript中catch语句无法指定自定义错误接口问题（Node.js + Mongoose环境）

这个错误是TypeScript的安全限制导致的：catch语句里的错误变量如果要指定类型，只能是any或unknown。这是因为JavaScript允许抛出任何类型的值（字符串、数字、对象甚至undefined），TypeScript无法提前确定catch捕获到的错误到底是什么类型，所以不允许直接指定自定义接口类型。

针对你的Mongoose开发场景，有两种推荐的解决方案：

方案1：使用unknown类型+类型守卫（最安全） #

先把catch里的err声明为unknown，然后在getError函数内部通过类型守卫确认它符合你需要的错误结构，或者直接利用Mongoose自带的错误类型来做更精准的判断：

步骤1：修改getError函数 #

Mongoose本身提供了内置的错误类型，比如ValidationError（验证错误的标准类型），直接使用它比自定义接口更准确：

import { ValidationError } from 'mongoose';

const getError = (err: unknown) => {
  // 类型守卫：判断err是否是Mongoose的ValidationError实例
  if (err instanceof ValidationError) {
    // 此时TypeScript会自动识别err的类型，可安全访问errors属性
    return Object.keys(err.errors).map(key => {
      // Mongoose错误对象默认包含message属性，用于返回用户友好提示
      return err.errors[key].message;
    });
  }
  // 处理非验证类错误的情况
  return ['发生未知错误'];
};

如果坚持使用自定义接口，也可以通过结构检查实现类型守卫：

export interface MongoError { 
  errors: { [index: string]: { message?: string } } 
}

const getError = (err: unknown) => {
  // 结构检查：确认err是包含errors属性的对象
  if (typeof err === 'object' && err !== null && 'errors' in err) {
    const mongoErr = err as MongoError;
    return Object.keys(mongoErr.errors).map(key => {
      return mongoErr.errors[key].message || '字段验证失败';
    });
  }
  return ['发生未知错误'];
};

步骤2：修改catch语句 #

try {
  await mongooElement.save();
  return NewItem;
} catch (err: unknown) { // 这里指定为unknown类型
  return this.getError(err);
}

方案2：临时用any类型（快速解决，安全性稍低） #

如果你能100%确定catch捕获到的一定是Mongoose错误，可以暂时用any绕过类型限制，再做类型断言：

catch (err: any) {
  // 将err断言为自定义的MongoError类型
  return this.getError(err as MongoError);
}

不过这种方式跳过了TypeScript的类型检查，隐藏了潜在的类型风险，不推荐在大型项目中使用。

为什么会有这个限制？ #

TypeScript的这个设计是为了避免开发者错误地假设catch到的错误一定是某个特定类型——毕竟JavaScript里throw '出错了'或者throw 500都是合法的，直接指定自定义接口类型会忽略这些潜在的异常场景。

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