TypeScript调用mysql2.createConnection报错：No overload matches this call

这个是TypeScript类型校验触发的报错，核心原因是process.env下的所有属性默认类型为string | undefined，而mysql2的ConnectionOptions类型要求host、user、password必填且必须为字符串类型，再加上你开启了exactOptionalPropertyTypes严格校验，就会触发该报错。

方法1：提前校验环境变量（生产环境推荐） #

创建连接前先校验必要环境变量是否存在，既可以解决类型报错，还能避免运行时因为环境变量缺失导致的数据库连接异常：

const requiredEnvs = ['SQL_HOST', 'SQL_USER', 'SQL_PASSWORD'] as const;
for (const envKey of requiredEnvs) {
  if (!process.env[envKey]) {
    throw new Error(`缺失必要环境变量：${envKey}`);
  }
}

const db = mysql.createConnection({
  host: process.env.SQL_HOST,
  user: process.env.SQL_USER,
  password: process.env.SQL_PASSWORD,
});

经过校验后TypeScript会自动推导出这几个环境变量都是非空的string类型，不会再报类型错误。

方法2：类型断言（本地开发快速解决） #

确定环境变量肯定配置齐全的场景下，可以直接用as断言变量为string类型：

const db = mysql.createConnection({
  host: process.env.SQL_HOST as string,
  user: process.env.SQL_USER as string,
  password: process.env.SQL_PASSWORD as string,
});

方法3：全局声明process.env类型（全项目通用） #

在项目的类型声明文件（通常为env.d.ts或typings.d.ts）中补充process.env的明确类型：

declare global {
  namespace NodeJS {
    interface ProcessEnv {
      SQL_HOST: string;
      SQL_USER: string;
      SQL_PASSWORD: string;
      // 其他项目用到的环境变量可以在这里统一补充
    }
  }
}

export {}

配置后全项目读取对应环境变量都会默认识别为string类型，无需单独处理类型问题。

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