3. 集成测试环境搭建：Docker Compose 编排数据库容器、配置 Liquibase 连接参数、初始化测试数据库

集成测试环境的核心目标是提供一个可重复、隔离、与生产环境高度一致的数据库运行时。本章将使用 Docker Compose 编排 PostgreSQL 容器，配置 Liquibase 连接参数，并完成测试数据库的初始化。整个流程确保每次运行冒烟验证时，数据库状态都是干净且可预测的。

3.1 环境架构概览

下图展示了集成测试环境的核心组件及其交互关系：

3.2 Docker Compose 编排数据库容器

使用 Docker Compose 可以一键启动、停止和重建数据库容器，确保测试环境的一致性和隔离性。以下是一个典型的 docker-compose.yml 配置：

version: '3.8'
services:
  postgres-test:
    image: postgres:15-alpine
    container_name: liquibase-integration-test-db
    environment:
      POSTGRES_USER: test_user
      POSTGRES_PASSWORD: test_pass
      POSTGRES_DB: integration_test_db
    ports:
      - "5432:5432"
    volumes:
      - ./init-scripts:/docker-entrypoint-initdb.d
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U test_user -d integration_test_db"]
      interval: 5s
      timeout: 3s
      retries: 5
    networks:
      - test-net

networks:
  test-net:
    driver: bridge

3.3 配置 Liquibase 连接参数

Liquibase 通过 liquibase.properties 文件或环境变量获取数据库连接信息。在集成测试中，推荐使用属性文件方式，便于版本控制和参数化：

# liquibase.properties
changeLogFile: db/changelog/db.changelog-master.xml
url: jdbc:postgresql://localhost:5432/integration_test_db
username: test_user
password: test_pass
driver: org.postgresql.Driver
defaultSchemaName: public
liquibaseSchemaName: liquibase_changelog
liquibaseTablespaceName: pg_default

3.4 初始化测试数据库

数据库初始化分为两个阶段：基础 Schema 创建和Liquibase 变更集执行。

3.4.1 基础初始化脚本

在 init-scripts/ 目录下创建 01-init-schema.sql，用于创建必要的扩展和基础对象：

-- 01-init-schema.sql
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
CREATE EXTENSION IF NOT EXISTS "pgcrypto";

-- 创建测试专用的 schema
CREATE SCHEMA IF NOT EXISTS test_data;

-- 设置默认权限
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT ALL ON TABLES TO test_user;
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT ALL ON SEQUENCES TO test_user;

3.4.2 Liquibase 变更集执行

使用 Maven 插件或命令行执行 Liquibase 迁移。以下是 Maven 插件的配置示例：

<plugin>
    <groupId>org.liquibase</groupId>
    <artifactId>liquibase-maven-plugin</artifactId>
    <version>4.25.0</version>
    <configuration>
        <propertyFile>src/test/resources/liquibase.properties</propertyFile>
    </configuration>
    <executions>
        <execution>
            <phase>pre-integration-test</phase>
            <goals>
                <goal>update</goal>
            </goals>
        </execution>
    </executions>
</plugin>

执行命令：

mvn liquibase:update -P integration-test

3.5 初始化流程时序

下图展示了从容器启动到数据库就绪的完整时序：

3.6 验证环境就绪

执行以下命令验证环境是否搭建成功：

# 1. 启动容器
docker-compose -f docker-compose.yml up -d

# 2. 检查容器健康状态
docker ps --filter "name=liquibase-integration-test-db" --format "{{.Status}}"

# 3. 执行 Liquibase 迁移
mvn liquibase:update -P integration-test

# 4. 验证迁移状态
mvn liquibase:status -P integration-test

3.7 常见问题与解决方案