TypeScript报错：ChangeStreamDropDocument无fullDocument属性

核心问题 #

你遇到的类型错误是Mongoose本体版本与@types/mongoose类型定义版本不兼容导致的：

• Mongoose 6.x版本开始，官方已内置完整的TypeScript类型定义，不再需要依赖第三方的@types/mongoose包
• 你当前安装的@types/mongoose@5.11.97是针对Mongoose 5.x的旧类型定义，它和Mongoose 6.x的内置类型发生冲突，导致TypeScript解析ChangeStreamDocument<IUser>时使用了旧的、不完整的类型结构——旧类型中ChangeStreamDropDocument未定义fullDocument属性，而Mongoose 6的ChangeStream事件体系里，不同事件类型（如insert/update/drop）的结构本就不同，旧类型定义的联合类型处理逻辑和新版本不匹配。

解决步骤 #

1. 卸载冲突的@types/mongoose #

因为Mongoose 6+自带类型，直接移除旧的类型包：

npm uninstall @types/mongoose
# 或使用yarn
yarn remove @types/mongoose

2. 清理TypeScript缓存（可选） #

如果卸载后仍有类型报错，清理缓存确保TypeScript加载最新的内置类型：

rm -rf node_modules/.cache
npx tsc --clearCache

3. 代码层面优化（可选） #

由于ChangeStreamDocument是多种事件类型的联合类型（仅insert/update等事件存在fullDocument，drop事件确实没有），可以添加类型守卫缩小类型范围，避免后续潜在报错：

// 检查data是否包含fullDocument属性
if ('fullDocument' in data) {
  const id = data.fullDocument?.user_id || '';
  // 你的业务逻辑
} else {
  // 处理无fullDocument的事件（如drop），比如跳过或记录日志
  console.log('Received change stream event without fullDocument:', data);
}

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