Spring Boot 3.1配置application.properties启动Testcontainers MySQL数据库

背景 #

现有Spring Boot 3.1应用，测试类通过@Testcontainers能正常启动MySQL容器，但在运行完整应用上下文时，配置application.properties后出现错误：java.lang.UnsupportedOperationException: Database name mysql not supported。当前依赖和配置存在冲突与缺失。

解决方案 #

1. 修复Gradle依赖冲突与缺失 #

当前build.gradle中MySQL驱动依赖重复，且Testcontainers MySQL模块仅在测试依赖中，需调整如下：

dependencies {
    // Testcontainers核心JDBC模块（运行完整应用需要）
    implementation 'org.testcontainers:jdbc:1.19.0'
    // Testcontainers MySQL模块（必须添加，否则无法识别mysql类型）
    implementation 'org.testcontainers:mysql:1.19.0'

    testImplementation 'org.springframework.boot:spring-boot-starter-test'
    testImplementation 'org.springframework.boot:spring-boot-testcontainers'
    testImplementation 'org.testcontainers:junit-jupiter'

    developmentOnly 'org.springframework.boot:spring-boot-devtools'

    implementation 'org.springframework.boot:spring-boot-starter-data-jdbc'
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    implementation 'org.springframework.boot:spring-boot-starter-jdbc'
    // 统一MySQL驱动（保留一个即可，推荐用最新groupId）
    runtimeOnly 'com.mysql:mysql-connector-j:8.0.33'
    // 移除重复的mysql-connector-java依赖
    // implementation group: 'mysql', name: 'mysql-connector-java', version: '8.0.28'
    // runtimeOnly 'mysql:mysql-connector-java'
}

2. 正确配置application.properties #

调整JDBC URL格式，并确保驱动类配置正确：

# Testcontainers JDBC URL格式：jdbc:tc:<数据库类型>:<版本>:///<数据库名>
spring.datasource.url=jdbc:tc:mysql:8.0.33:///contosodb
spring.datasource.username=root
spring.datasource.password=secret
# 手动指定Testcontainers代理驱动（避免Spring自动识别错误）
spring.datasource.driver-class-name=org.testcontainers.jdbc.ContainerDatabaseDriver

补充说明：

• 建议指定具体MySQL版本（如8.0.33）而非latest，避免版本兼容问题
• 若需要初始化数据库脚本，可添加URL参数：?TC_INITSCRIPT=classpath:init.sql

3. 关于每次启动新容器的说明 #

Testcontainers JDBC模式默认行为：

• 每次启动Spring应用时，会自动创建全新的MySQL容器
• 应用关闭时，容器会被自动销毁（无需手动清理）
• 若需复用容器（开发环境提速），可添加系统属性：testcontainers.reuse.enable=true，但不推荐用于需要干净环境的场景

错误原因解析 #

出现Database name mysql not supported的核心原因：

• 缺少org.testcontainers:mysql的implementation依赖，Testcontainers JDBC模块无法识别MySQL数据库类型
• MySQL驱动依赖重复，导致类加载冲突

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