TS类型定义错误致云函数无法部署的原因及修复方法

云函数部署流程默认会先执行项目里配置的build脚本，你的项目是TypeScript项目，build脚本执行的是tsc编译命令。TS编译器默认配置下，只要检测到任何类型错误（包括找不到依赖的类型定义文件），就会终止编译并返回非0的退出状态码；npm只要检测到脚本执行返回非0状态码，就会判定构建失败，直接中断后续的部署上传步骤。

类型错误并非和运行完全无关：大部分TS类型报错都对应着潜在的运行时风险，比如调用不存在的方法、传参类型不匹配等，直接跳过检查部署很容易触发线上故障。
如果确实需要临时跳过该检查强行部署，可以修改项目根目录的tsconfig.json文件，在compilerOptions配置项中添加"skipLibCheck": true，这个配置会跳过所有第三方依赖声明文件的类型检查，可以绕过你遇到的这个类型定义找不到的报错，但不推荐长期使用这个方案。

你之前执行安装命令时出现了语法错误：包名和版本号之间多打了空格，把@types/jsonwebtoken@2拆成了@types/jsonwebtoken和2两个独立的包名，才会出现npm尝试安装名为2的依赖的警告，按以下步骤修复即可：

• 先卸载误安装的无效依赖

npm uninstall 2

• 正确安装jsonwebtoken对应的类型定义包，注意包名和版本号之间用@连接，不要加空格：

npm install @types/jsonwebtoken@2 --save-dev

如果项目里还没安装jsonwebtoken主包，补装主包：

npm install jsonwebtoken@2 --save

• （推荐）处理Node版本兼容警告
  你本地当前运行的Node版本是v17.5.0，和云函数要求的Node 16大版本不匹配，这个警告虽然不会直接导致构建失败，但可能出现本地安装的依赖和线上运行环境不兼容的问题，建议将本地Node版本切换到16.x大版本后再执行部署，避免后续出现运行时异常。
• 本地验证修复结果
  执行本地构建命令，确认无报错：

npm run build

构建正常通过后，重新执行云函数部署流程即可。

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