解决 Quarkus 测试、测试容器和 Liquibase 集成的问题

确保 Quarkus 中 Liquibase 和 TestContainers 之间的正确集成

使用 Quarkus 和 TestContainers 来管理 PostgreSQL 和 Liquibase 迁移的后端解决方案。此脚本解决了容器未对齐问题。

import org.testcontainers.containers.PostgreSQLContainer;
import org.testcontainers.utility.DockerImageName;
import java.util.HashMap;
import java.util.Map;
public class PostgreSQLTestResource implements QuarkusTestResourceLifecycleManager {
    private static PostgreSQLContainer<?> postgreSQLContainer;
    @Override
    public Map<String, String> start() {
        postgreSQLContainer = new PostgreSQLContainer<>(DockerImageName.parse("postgres:alpine"))
            .withDatabaseName("test")
            .withUsername("postgres")
            .withPassword("password")
            .withReuse(true);
        postgreSQLContainer.start();
        Map<String, String> config = new HashMap<>();
        config.put("quarkus.datasource.jdbc.url", postgreSQLContainer.getJdbcUrl());
        config.put("quarkus.datasource.username", postgreSQLContainer.getUsername());
        config.put("quarkus.datasource.password", postgreSQLContainer.getPassword());
        return config;
    }
    @Override
    public void stop() {
        if (postgreSQLContainer != null) {
            postgreSQLContainer.stop();
        }
    }
}

使用单元测试验证应用程序-Liquibase 集成

模块化且可重用的 Quarkus 测试示例，用于验证数据库连接和迁移脚本的执行。

import org.junit.jupiter.api.Test;
import io.quarkus.test.junit.QuarkusTest;
import io.quarkus.test.junit.TestProfile;
@QuarkusTest
@TestProfile(TestProfileResolver.class)
public class XServiceTest {
    @Inject
    XTypeVersionService xTypeVersionService;
    @Test
    public void getXTypeVersion() {
        List<XTypeVersionEntity> entities = xTypeVersionService.get();
        assertFalse(entities.isEmpty(), "The entity list should not be empty.");
    }
}

确保测试配置文件之间的配置一致性

自定义测试配置文件配置，以保证 Liquibase 和应用程序容器之间的一致性。

public class TestProfileResolver implements QuarkusTestProfile {
    @Override
    public String getConfigProfile() {
        return "test";
    }
    @Override
    public Map<String, String> getConfigOverrides() {
        return Map.of("quarkus.config.locations", "src/test/resources/application.yaml");
    }
}

用于数据验证的前端仿真

动态前端代码片段，确保正确显示数据库集成的数据。

fetch('/api/xTypeVersion')
    .then(response => response.json())
    .then(data => {
        const list = document.getElementById('entity-list');
        data.forEach(entity => {
            const item = document.createElement('li');
            item.textContent = entity.name;
            list.appendChild(item);
        });
    })
    .catch(error => console.error('Error fetching data:', error));

后端和前端一致性的单元测试

用于验证后端逻辑和前端与测试数据集成的示例测试脚本。

import org.junit.jupiter.api.Test;
public class FrontEndValidationTest {
    @Test
    public void fetchData() {
        given().when().get("/api/xTypeVersion")
            .then().statusCode(200)
            .body("size()", greaterThan(0));
    }
}

关于 Quarkus、TestContainers 和 Liquibase 集成的常见问题解答

1. 的作用是什么 TestContainers 在集成测试中？
2. TestContainers 帮助在测试期间管理隔离的数据库实例，确保环境一致。
3. 为什么我需要 withReuse(true) 命令？
4. 这 withReuse(true) 命令允许您在多个测试中重复使用同一容器，从而节省资源和设置时间。
5. 目的是什么 TC_INITSCRIPT 财产？
6. 这 TC_INITSCRIPT 属性指定一个初始化 SQL 脚本，用于在容器启动时为数据库播种。
7. 如何确保正确应用 Liquibase 迁移？
8. 通过配置 quarkus.liquibase.jdbc.url 属性，您可以确保 Liquibase 使用与应用程序相同的数据库容器。
9. 我应该使用什么日志级别进行调试？
10. 放 TRACE 或者 DEBUG Liquibase 和 TestContainers 监控数据库操作和迁移的级别。
11. 如何使用种子数据测试 API 响应？
12. 使用类似的工具 RestAssured 向端点发送请求并验证返回的数据与测试数据匹配。
13. 什么是 @QuarkusTestResource 注释做什么？
14. 这 @QuarkusTestResource 注解为数据库等外部依赖项注册自定义生命周期管理器。
15. 为什么我需要自定义 TestProfileResolver？
16. 它确保加载正确的配置以执行测试，调整环境变量和资源。
17. 如何检测是否正在创建多个容器？
18. 检查您的 Docker 桌面或监视控制台日志中是否有重复的容器实例及其各自的端口。
19. 清理测试资源的最佳方法是什么？
20. 覆盖 stop 生命周期管理器中的方法，用于在测试完成后停止并删除容器。

解决测试冲突的关键要点

与 Quarkus、Liquibase 和 TestContainers 的集成测试需要仔细设置，以确保迁移和数据库交互保持一致。通过自定义测试资源管理器并使用统一配置，您可以消除 Liquibase 使用的容器与应用程序之间的冲突。

这些步骤有助于简化您的测试过程，使调试和验证测试变得更加容易。请记住使用详细的日志，例如启用 痕迹 对于 Liquibase，监控测试的行为并尽早解决差异。通过这种方法，您可以自信地构建可扩展且可维护的测试。 🐛