NestJs连接本地MySQL遇认证协议不支持错误求助

核心问题分析 #

你遇到的ER_NOT_SUPPORTED_AUTH_MODE错误本质是驱动与MySQL服务器认证协议不兼容：虽然安装了mysql2，但TypeORM可能仍在使用旧的mysql驱动包，而mysql2才支持MySQL 8.0+默认的caching_sha2_password认证协议。启动时仅创建部分实体表后崩溃，是因为连接初始化未完全完成，同步表的操作中途终止。

解决方案步骤 #

1. 强制TypeORM使用mysql2驱动 #

在DataSource配置中显式指定驱动为mysql2，确保TypeORM不会 fallback 到旧的mysql包：

import { DataSource } from 'typeorm';
import * as mysql2 from 'mysql2';

export const databaseProviders = [
  {
    provide: 'DATA_SOURCE_LOCAL',
    useFactory: async () => {
      const dataSource = new DataSource({
        type: 'mysql',
        host: '127.0.0.1',
        port: 3306,
        username: 'root',
        password: 'root',
        database: 'myDb',
        entities: [Quiz, Question, User, Profile],
        synchronize: true,
        // 显式指定使用mysql2驱动
        driver: mysql2,
      });

      return dataSource.initialize();
    },
  },
];

2. 清理冗余依赖 #

删除package.json中的mysql依赖，避免驱动冲突：

npm uninstall mysql
# 或使用yarn
yarn remove mysql

3. 验证配置有效性 #

修改配置后重启应用，TypeORM会通过mysql2驱动建立完整连接，一次性同步所有实体表，不会再出现中途崩溃的情况。

关于type: 'mysql'与mysql2的关系说明 #

TypeORM的type字段是数据库类型的标识（而非驱动包名），当type设为mysql时，它会自动尝试加载mysql或mysql2驱动包。但为了确保优先使用mysql2，显式指定driver字段是最可靠的方式，尤其在同时安装了两个驱动包的场景下。

为什么修改用户认证方式无效？ #

你尝试的ALTER USER方案无效，大概率是因为应用仍在使用旧的mysql驱动——即使修改了用户认证方式，旧驱动不支持mysql_native_password以外的协议（或配置未生效）。切换到mysql2驱动后，无需修改用户认证方式即可兼容默认的caching_sha2_password，更符合生产/云数据库的最佳实践。

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