如何通过自定义JDBC URL利用TestContainers获取临时MSSQL测试数据库

1. 添加必要依赖 #

如果使用Maven，在pom.xml中加入：

<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>mssqlserver</artifactId>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>junit-jupiter</artifactId>
    <scope>test</scope>
</dependency>

如果使用Gradle，在build.gradle中加入：

testImplementation 'org.testcontainers:mssqlserver'
testImplementation 'org.testcontainers:junit-jupiter'

2. 修改application-test.yaml配置 #

替换原有的H2配置，改用TestContainers的MSSQL JDBC URL：

spring:
  datasource:
    url: jdbc:tc:sqlserver:2022://localhost;databaseName=master;TC_INIT_SCRIPT=file:src/test/resources/init-dbo-schema.sql
    username: sa
    password: YourStrong!Passw0rd
    driver-class-name: org.testcontainers.jdbc.ContainerDatabaseDriver
  jpa:
    hibernate:
      ddl-auto: none # 用初始化脚本处理Schema，避免Hibernate自动生成逻辑冲突

3. 替代H2的INIT参数：处理Schema初始化 #

原H2配置中的INIT参数用来创建并切换到dbo Schema，MSSQL可以通过TestContainers的TC_INIT_SCRIPT指定初始化脚本。在src/test/resources下创建init-dbo-schema.sql文件：

IF NOT EXISTS (SELECT * FROM sys.schemas WHERE name = N'dbo')
BEGIN
    EXEC('CREATE SCHEMA dbo');
END;
SET SCHEMA dbo;

关键细节说明 #

• JDBC URL前缀jdbc:tc:sqlserver:2022://指定使用TestContainers启动SQL Server 2022镜像，可根据需求替换为2019等其他版本
• TC_INIT_SCRIPT支持classpath路径（如classpath:init-dbo-schema.sql）或本地文件路径
• MSSQL默认要求密码符合复杂度规则，必须包含大小写字母、数字和特殊字符
• ContainerDatabaseDriver是TestContainers提供的驱动，会自动启动、管理并销毁MSSQL容器

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