Spring Boot集成测试中AssignmentRepository注入失败报空指针

问题分析 #

你遇到的NullPointerException是因为Spring上下文未成功初始化并注入AssignmentRepository实例，常见诱因包括父类容器配置缺失、Spring扫描范围不足、Testcontainers配置错误等。

解决方案 #

1. 修正父类ContainerEnvironment的Testcontainers配置 #

确保父类正确配置测试容器与动态属性，示例如下：

@Testcontainers
public abstract class ContainerEnvironment {

    @Container
    private static final PostgreSQLContainer<?> postgresContainer = new PostgreSQLContainer<>("postgres:15-alpine")
            .withDatabaseName("testdb")
            .withUsername("testuser")
            .withPassword("testpass");

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

• 必须添加@Testcontainers注解，否则容器无法启动，数据源配置失效。
• @DynamicPropertySource用于动态注入容器的数据库连接参数，确保Spring连接到测试容器内的数据库。

2. 确保Spring扫描范围覆盖Repository #

检查RestapiApplication所在包是否为AssignmentRepository包的上级（Spring Boot默认扫描主类所在包及其子包）。若Repository在非子包路径下，需在@SpringBootTest中指定扫描范围：

@SpringBootTest(classes = RestapiApplication.class, 
                webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT,
                scanBasePackages = {"com.company.restapi", "com.company.restapi.dal"})

3. 简化测试类注解 #

Spring Boot 2.2+版本中，@SpringBootTest已包含@ExtendWith(SpringExtension.class)，可删除冗余注解：

@ActiveProfiles("test")
@SpringBootTest(classes = RestapiApplication.class, webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class AssignmentRepositoryTest extends ContainerEnvironment {
    // ... 原有代码
}

4. 排查application-test.properties配置 #

删除测试环境配置文件中硬编码的数据源URL，避免覆盖Testcontainers的动态配置：

# 需删除的错误示例：硬编码URL会导致连接本地数据库而非测试容器
spring.datasource.url=jdbc:postgresql://localhost:5432/testdb

5. 清理并重新编译项目 #

编译缓存可能导致类无法被Spring正确识别，执行mvn clean install（或Gradle的clean build）后重新运行测试。

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