使用TestContainers进行Spring Boot MySQL集成测试时遇BeanDefinitionStoreException

常见排查方向及解决方案 #

1. 给MySQL容器添加就绪等待策略 #

BeanDefinitionStoreException大多是因为Spring还没等MySQL容器完全启动，就尝试创建数据源连接。MongoDB连接逻辑更宽松，所以没触发这个问题。
直接给容器加上等待日志的策略，确保数据库就绪后再让Spring初始化：

@Container
private static final MySQLContainer<?> mysqlContainer = new MySQLContainer<>("mysql:8.0")
        .withDatabaseName("testdb")
        .withUsername("testuser")
        .withPassword("testpass")
        .withWaitStrategy(Wait.forLogMessage(".*ready for connections.*", 1));

如果是Spring Boot 3.1+版本，直接用@ServiceConnection注解更省心，它会自动处理容器就绪等待，不用手动配置数据源属性：

@Container
@ServiceConnection
private static final MySQLContainer<?> mysqlContainer = new MySQLContainer<>("mysql:8.0");

2. 确保数据源配置动态注入正确 #

别硬编码本地MySQL的地址端口，必须动态获取容器的参数注入到Spring环境：

@DynamicPropertySource
static void registerMySQLProperties(DynamicPropertyRegistry registry) {
    registry.add("spring.datasource.url", mysqlContainer::getJdbcUrl);
    registry.add("spring.datasource.username", mysqlContainer::getUsername);
    registry.add("spring.datasource.password", mysqlContainer::getPassword);
}

注意：用了@ServiceConnection就不用写这段代码了，Spring会自动绑定参数。

3. 匹配MySQL镜像和JDBC驱动版本 #

旧版MySQL镜像（比如5.7以下）可能和TestContainers、Spring Boot的JDBC驱动不兼容。明确指定兼容的版本，比如：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.36</version>
    <scope>test</scope>
</dependency>

容器镜像也用对应版本：new MySQLContainer<>("mysql:8.0.36")

4. 避免本地MySQL端口冲突 #

如果本地开着MySQL占用3306端口，测试配置又硬编码了3306，就会连到本地MySQL而非容器实例，直接导致Bean创建失败。
要么停掉本地MySQL服务，要么确保测试完全用容器的动态端口（通过getJdbcUrl()获取，别写死localhost:3306）。

5. 检查测试类注解是否齐全 #

测试类必须同时加@SpringBootTest和@Testcontainers注解，否则容器不会被正确初始化：

@SpringBootTest
@Testcontainers
public class MyMySQLIntegrationTest {
    // 测试代码
}

日志排查重点 #

如果以上方法没用，盯着异常的根因（看Caused by部分）：

• 要是出现Communications link failure，直接查容器是否就绪、配置参数是否正确；
• 要是出现Error creating bean with name 'dataSource'，检查有没有自定义数据源配置覆盖了TestContainers的参数。

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