5154

在使用 NestJS 连接 MySQL 数据库时，开发者可能会遇到各种报错问题，这些问题可能源于配置错误、依赖缺失、版本不兼容或连接参数不当等，本文将详细介绍常见报错类型、排查方法及解决方案,帮助开发者快速定位并解决问题。

常见报错类型及原因

1. ModuleNotFoundError: Module '@nestjs/typeorm' not found
   这种错误通常是因为未安装相关依赖包或未在模块中正确引入 TypeORM，确保已安装 @nestjs/typeorm、typeorm 和 mysql2 依赖包，并在 app.module.ts 中正确导入 TypeOrmModule。

2. Access denied for user 'root'@'localhost'
   报错提示数据库用户权限不足，可能是密码错误或用户未授权访问指定数据库，检查 app.module.ts 中的数据库配置，确保用户名、密码和数据库名称正确。

3. Unable to connect to the database
   此类错误通常由网络问题或数据库服务未启动导致，确认 MySQL 服务是否运行，检查数据库端口号（默认为 3306）是否被占用或防火墙是否阻止了连接。

4. Unknown database 'dbname'
   错误表示配置的数据库名不存在，在 MySQL 中创建该数据库,或检查配置文件中的数据库名称拼写是否正确。

5. Error: ER_NOT_SUPPORTED_AUTH_MODE
   较新版本的 MySQL 默认使用 caching_sha2_password 认证方式，而旧版本的 NestJS 或驱动可能不支持，可通过以下方式解决：

   

   • 在 MySQL 中修改用户认证方式：

     ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password';

   • 或在连接选项中添加 authPlugin: 'mysql_native_password'。

解决方案与最佳实践

1. 检查依赖与配置
   确保所有依赖包版本兼容，在 package.json 中锁定版本，避免因版本差异导致问题，检查 app.module.ts 中的数据库配置，确保 type: 'mysql'、host、port、username、password 和 database 字段正确。

2. 验证数据库服务状态
   通过命令行或管理工具检查 MySQL 是否运行，使用 mysql -u root -p 测试本地连接,确认服务可用。

3. 使用环境变量管理配置
   将敏感信息（如密码）存储在 .env 文件中，通过 ConfigModule 动态加载，避免硬编码。

   TypeOrmModule.forRootAsync({
     imports: [ConfigModule],
     useFactory: (configService: ConfigService) => ({
       type: 'mysql',
       host: configService.get<string>('DB_HOST'),
       port: configService.get<number>('DB_PORT'),
       username: configService.get<string>('DB_USER'),
       password: configService.get<string>('DB_PASSWORD'),
       database: configService.get<string>('DB_NAME'),
       autoLoadEntities: true,
     }),
   }),

4. 启用详细日志
   在 TypeORM 配置中添加 logging: true，输出 SQL 查询和错误详情,便于调试。

5. 处理连接池问题
   如果频繁出现连接超时，可调整连接池参数：

   

   extra: {
     connectionLimit: 10,
     acquireTimeout: 60000,
   },

FAQs

Q1: 如何解决 NestJS 连接 MySQL 时出现 "ETIMEDOUT" 错误？
A: 此错误通常表示连接超时，检查网络连接是否稳定，确认 MySQL 服务的 wait_timeout 和 interactive_timeout 参数是否过短，可通过修改 MySQL 配置文件（my.cnf）增加超时时间，或在连接选项中设置 connectTimeout: 60000（单位为毫秒）。

Q2: 为什么 NestJS 启动时报错 "Cannot read properties of undefined (reading 'isConnected)"？
A: 此错误通常因未正确注入或使用 Connection 对象导致，确保在服务中通过 @InjectConnection() 注入连接实例，并检查是否在模块中正确配置了 TypeOrmModule.forFeature()。

@Injectable()
export class UserService {
  constructor(
    @InjectConnection() private readonly connection: Connection,
  ) {}
}