npm build报错TS2305：模块'bson'无导出成员'Map'

这个错误本质是mongodb与bson的版本不兼容导致的类型定义冲突，以下是具体解决步骤：

1. 锁定兼容的bson版本 #

某些mongodb版本（比如4.x系列）依赖特定版本的bson，新版本bson可能移除了Map的导出，导致类型导入失败。

• 先卸载现有bson：

  npm uninstall bson
  

• 安装与你的mongodb版本匹配的bson，比如mongodb 4.x对应bson 4.7.x：

  npm install bson@4.7.2
  

• 也可以直接在package.json里固定版本，避免后续安装自动升级：

  "dependencies": {
    "bson": "^4.7.2",
    "mongodb": "^4.13.0",
    // 其他项目依赖...
  }
  

2. 清理依赖缓存并重装 #

依赖缓存可能导致版本混乱，执行以下命令彻底重置依赖：

rm -rf node_modules package-lock.json
npm install

3. 检查TypeScript配置 #

确保tsconfig.json的编译选项支持ES6及以上特性，且模块解析正确：

{
  "compilerOptions": {
    "moduleResolution": "node",
    "target": "ES6",
    "esModuleInterop": true,
    "skipLibCheck": true // 可选：临时跳过库类型检查，快速规避冲突
  }
}

注：skipLibCheck是应急方案，优先用版本匹配从根源解决问题。

4. 验证session存储依赖版本 #

如果用connect-mongo作为Express Session的MongoDB存储，确保它的版本与mongodb兼容：

• 比如connect-mongo 4.x对应mongodb 4.x，执行：

  npm install connect-mongo@4.6.0
  

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