Next.js + Typescript 用global.mongoose做Mongoose缓存连接报TS7017错误如何解决

TypeScript 默认没有在 globalThis（也就是Node.js环境的global对象）上定义mongoose属性，所以访问global.mongoose时会触发索引签名缺失的ts(7017)类型错误。

方案1：快速临时修复（适合快速调试） #

直接给global加上any类型断言，绕过类型检查，修改dbConnect.ts里对应两行代码即可：

// 替换原有的 let cached = global.mongoose
let cached = (global as any).mongoose;

if (!cached) {
  // 替换原有的 cached = global.mongoose = { conn: null, promise: null }
  cached = (global as any).mongoose = { conn: null, promise: null };
}

缺点是丢失了类型校验，不建议长期使用。

方案2：全局类型扩展（推荐，符合TS规范） #

通过类型声明文件扩展全局对象的类型，一劳永逸解决问题，还保留完整类型校验：

1. 在项目根目录新建global.d.ts类型声明文件，写入以下内容：

import mongoose from "mongoose";

declare global {
  // 注意必须用var声明，才能正确挂载到globalThis上
  var mongoose: {
    conn: typeof mongoose | null;
    promise: Promise<typeof mongoose> | null;
  };
}

2. 确认该声明文件被tsconfig.json的include配置项覆盖，比如你的tsconfig.json里的include数组应该包含"**/*.ts"或者显式添加"global.d.ts"：

{
  "compilerOptions": {/* 原有配置保持不变 */},
  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", "global.d.ts"]
}

3. 重启TypeScript服务（VSCode中按Ctrl+Shift+P，选择「TypeScript: Restart TS Server」），原有报错就会消失，不需要修改dbConnect.ts的原有代码。

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