TypeScript编译报错：Error构造函数的cause参数不被识别

问题核心原因 #

你当前使用的TypeScript 4.7.4版本不支持Error构造函数的第二个参数（cause选项）的类型定义，该特性的类型支持是从TypeScript 4.9版本才正式加入的。虽然Node.js版本满足运行时要求，但TypeScript本身的类型检查逻辑还未覆盖这个特性。

解决方案 #

方案一：升级TypeScript到4.9及以上版本 #

这是最彻底的解决方式，执行以下命令更新依赖：

npm install typescript@^4.9.0 --save-dev

更新完成后，执行tsc -v确认版本已升级，之后重新编译项目即可。

方案二：手动扩展Error类型声明（不升级TypeScript时使用） #

如果暂时无法升级TypeScript，可以通过添加全局类型声明来补全cause参数的类型支持：

1. 在项目根目录创建一个global.d.ts文件，写入以下内容：

interface ErrorOptions {
  cause?: unknown;
}

interface ErrorConstructor {
  new(message?: string, options?: ErrorOptions): Error;
}

2. 确保你的tsconfig.json的include配置包含了该声明文件（默认"include": ["**/*"]会自动包含.d.ts文件，无需额外修改）。

补充说明 #

虽然你安装的@types/node版本是18.7.6，但旧版本TypeScript无法正确识别其中新增的Error类型定义，因此升级TypeScript是更可靠的长期解决方案。

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