重装依赖后出现TS7016错误：找不到bson模块的声明文件

问题触发原因 #

重装依赖后触发报错的核心原因为依赖版本不匹配：

• 你本地安装的@types/mongodb属于已废弃的社区类型包，目前mongodb官方从4.x版本开始已经内置TypeScript类型定义，不再需要单独安装@types/mongodb
• 重装依赖时如果lock文件失效（被删除、或者安装时忽略lock配置），会拉取到版本不兼容的bson包，旧版@types/mongodb依赖的@types/bson版本和实际安装的bson包版本不匹配，就会抛出找不到类型的错误
• 单独安装最新版@types/bson无法解决问题的原因是，新版@types/bson的类型结构和旧版@types/mongodb要求的结构不兼容，版本对应不上自然不生效

解决方案 #

按优先级从高到低尝试即可：

方案1：移除废弃的@types/mongodb包（优先推荐） #

执行命令卸载单独的类型包：

npm uninstall @types/mongodb

卸载后重启TS服务或者重新编译即可恢复正常，官方内置的类型定义完全可以覆盖原有@types/mongodb的能力。

方案2：锁定@types/bson的兼容版本 #

如果你因为项目兼容性问题暂时不能升级mongodb、也不能移除@types/mongodb，可以安装和你现有@types/mongodb匹配的@types/bson版本：
首先查看你本地@types/mongodb的版本：

npm list @types/mongodb

比如你的@types/mongodb是3.6.x版本，就安装对应4.0.x版本的@types/bson：

npm i --save-dev @types/bson@4.0.5

版本对应关系可以查看@types/mongodb的package.json里的peerDependencies字段确认，安装匹配版本后即可解决类型不匹配问题。

方案3：临时绕过类型校验（应急用） #

如果只是临时调试不想改依赖，可以在项目的全局类型声明文件（一般是src目录下的env.d.ts或者global.d.ts）里添加一行声明：

declare module 'bson';

或者在tsconfig.json的compilerOptions里添加以下配置，关闭隐式any的报错：

{
  "compilerOptions": {
    "noImplicitAny": false
  }
}

注意：该方案只是临时绕过问题，没有从根本解决版本不匹配的隐患，不建议长期使用

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