如何为MySQL Test Containers配置查询参数及时区？

核心问题说明 #

Test Containers的JDBC URL格式（jdbc:tc:...）里的查询参数，多数是给JDBC驱动使用的，但服务器端时区、部分全局配置需要直接针对MySQL容器本身设置，而非通过JDBC URL传递；另外useLegacyDatetimeCode是驱动端参数，无需服务器端支持。

具体解决方案 #

1. 配置MySQL服务器时区（容器级设置） #

直接在启动MySQL容器时通过命令参数指定时区，以Spring Boot测试为例：

@Container
public static MySQLContainer<?> mysqlContainer = new MySQLContainer<>("mysql:5.7")
        .withCommand("--default-time-zone=Australia/Melbourne");

容器启动后，MySQL服务器会直接使用墨尔本时区，此时JDBC URL中的serverTimezone参数仅用于客户端驱动的时区适配，可保留也可省略。

2. 确保useLegacyDatetimeCode参数生效（驱动级设置） #

useLegacyDatetimeCode是MySQL JDBC驱动的客户端参数，无需服务器端识别，只要确保它被驱动正确读取即可：

• 在Spring Boot的application-test.properties中直接配置完整URL：

spring.datasource.url=jdbc:tc:mysql:5.7://database/myDb?useLegacyDatetimeCode=false&serverTimezone=Australia/Melbourne

• 若通过Test Containers API构建URL，可手动拼接参数：

String jdbcUrl = mysqlContainer.getJdbcUrl() + "?useLegacyDatetimeCode=false&serverTimezone=Australia/Melbourne";

该参数仅在驱动端生效，无需在容器或my.cnf中配置。

3. 自定义my.cnf配置更多服务器参数 #

如果需要批量配置服务器端参数，可挂载自定义配置文件：

1. 在测试资源目录（test/resources）创建my.cnf：

[mysqld]
default-time-zone = Australia/Melbourne
# 仅添加mysqld支持的配置项，useLegacyDatetimeCode不属于此类，不要添加

2. 在Test Containers中挂载该文件：

@Container
public static MySQLContainer<?> mysqlContainer = new MySQLContainer<>("mysql:5.7")
        .withCopyFileToContainer(MountableFile.forClasspathResource("my.cnf"), "/etc/mysql/conf.d/my.cnf");

MySQL启动时会自动加载该目录下的配置文件，覆盖默认设置。

关键注意事项 #

• useLegacyDatetimeCode是JDBC驱动专属参数，并非MySQL服务器配置项，这也是你之前通过my.cnf配置失败的原因。
• 服务器时区必须通过容器启动参数或my.cnf设置，JDBC URL中的serverTimezone仅用于客户端与服务器的时区适配。

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