TypeORM中MySQL时区设置问题的分析与解决方案

问题背景

在使用TypeORM连接MySQL数据库时，开发者经常会遇到时区设置不一致的问题。具体表现为：虽然已经通过SET @@session.time_zone = '+08:00'设置了会话时区，但在后续查询中时区设置会意外变回'SYSTEM'。

问题本质

这个问题的根源在于TypeORM的连接池机制。TypeORM的DataSource默认会维护一个数据库连接池，每次查询会从池中获取一个连接。当多个查询并行执行时，可能会分配到不同的数据库连接，而每个连接都有自己的会话状态和时区设置。

技术细节

1. 连接池行为：TypeORM的DataSource初始化后会创建多个数据库连接，这些连接被放入连接池中管理。每次查询时，TypeORM会从池中获取一个可用连接。

2. 会话变量范围：MySQL的会话变量(如time_zone)只对当前连接有效。当连接被释放回连接池后，下次使用时会话变量会被重置。

3. 并行查询影响：当多个查询同时执行时，它们可能分配到不同的连接，导致时区设置不一致。

解决方案

方案一：使用QueryRunner保持会话一致性

// 创建QueryRunner
const queryRunner = dataSource.createQueryRunner();

try {
    // 连接数据库并设置时区
    await queryRunner.connect();
    await queryRunner.query(`SET @@session.time_zone = '+08:00'`);
    
    // 执行所有需要相同时区设置的查询
    const result1 = await queryRunner.query('SELECT ...');
    const result2 = await queryRunner.query('SELECT ...');
    
    // 提交事务(如果有)
    await queryRunner.commitTransaction();
} catch (err) {
    // 回滚事务(如果有)
    await queryRunner.rollbackTransaction();
    throw err;
} finally {
    // 释放QueryRunner
    await queryRunner.release();
}

方案二：全局时区设置

如果应用所有查询都需要相同的时区，可以在创建DataSource时配置：

const dataSource = new DataSource({
    // ...其他配置
    timezone: '+08:00'
});

方案三：连接池初始化脚本

某些数据库驱动支持在创建连接时执行初始化SQL：

const dataSource = new DataSource({
    // ...其他配置
    extra: {
        initSQL: `SET @@session.time_zone = '+08:00'`
    }
});

最佳实践建议

1. 对于需要保持会话状态的场景，优先使用QueryRunner
2. 考虑在应用启动时统一设置数据库时区
3. 避免直接使用DataSource.query()执行依赖会话状态的查询
4. 对于Web应用，可以在中间件中创建QueryRunner并传递给后续处理

总结

TypeORM的时区问题本质上是连接池管理与会话状态的问题。理解TypeORM的连接池机制和MySQL的会话变量作用范围，可以帮助开发者更好地控制数据库行为。通过合理使用QueryRunner或全局配置，可以确保时区设置的一致性，避免因连接切换导致的问题。