你遇到的问题核心是没有正确扩展TypeScript对globalThis的类型定义——直接声明全局变量或者错误的类型合并方式，都会导致类型不兼容或丢失自动补全。下面是针对你的Express+MySQL场景的完整解决方案：

1. 正确扩展globalThis的类型定义 #

创建或修改项目根目录下的global.d.ts文件（如果没有就新建），通过全局接口合并的方式扩展globalThis的类型，同时保留MySQL Pool的类型提示：

// global.d.ts
// 用import type仅导入类型，避免引入运行时代码
import type { Pool } from 'mysql2/promise'; 
// 如果你用的是原生mysql包，改成 import type { Pool } from 'mysql';

declare global {
  // 扩展NodeJS全局对象类型（兼容Node.js环境）
  namespace NodeJS {
    interface Global {
      pool: Pool;
    }
  }

  // 直接扩展globalThis的类型（确保全局访问时类型正确）
  interface globalThis {
    pool: Pool;
  }
}

// 必须添加这一行，将文件标记为ES模块，否则全局类型合并不会生效
export {};

2. 确保TypeScript识别到类型文件 #

检查你的tsconfig.json，确保include数组包含了global.d.ts文件，比如：

{
  "compilerOptions": {
    // 你的其他配置
    "target": "ES2020",
    "module": "commonjs",
    "outDir": "./dist",
    "strict": true
  },
  "include": ["src/**/*", "global.d.ts"]
}

3. 初始化并挂载Pool到globalThis #

在你的数据库初始化文件中（比如db.ts），创建Pool并挂载到globalThis，此时TypeScript会自动识别类型，不会报错且有完整补全：

// src/db.ts
import mysql from 'mysql2/promise';

// 创建连接池
const pool = mysql.createPool({
  host: 'localhost',
  user: 'your_username',
  password: 'your_password',
  database: 'your_database',
  connectionLimit: 10,
  waitForConnections: true
});

// 挂载到globalThis，此时类型完全匹配
globalThis.pool = pool;

为什么之前的方法不行？ #

• 直接declare var pool: any;：虽然能消除错误，但丢失了Pool的类型信息，自然没有自动补全。
• 直接declare var pool: Pool;：这是在全局作用域声明了一个独立变量，但没有扩展globalThis的类型，所以访问globalThis.pool时，TypeScript仍认为globalThis没有这个属性，报错重现。
• 正确的方式是通过declare global块合并globalThis的接口类型，让TypeScript知道这个属性属于全局对象本身。

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