Kotlin与Spring Boot集成DbSetup测试报ClassNotFoundException求解

运行时类缺失的核心原因是依赖配置作用域错误，叠加传递依赖缺失

• 你在build.gradle.kts中将DbSetup-kotlin声明为testCompileOnly依赖，该作用域仅在测试代码编译阶段对类可见，测试启动运行时不会将对应包加入运行类路径，直接触发TypeNotPresentException: Type com.ninja_squad.dbsetup_kotlin.DbSetupBuilder not present异常。
• DbSetup-kotlin是对核心DbSetup库的Kotlin语法封装，单独引入kotlin扩展包不会自动拉取核心DbSetup依赖，缺少核心包也会触发连锁的类加载失败。

1. 调整构建文件的依赖声明 #

将原配置中单独的testCompileOnly依赖替换为以下配置，保证DbSetup相关包在测试编译、运行阶段均可正常加载：

// 移除原有 testCompileOnly("com.ninja-squad:DbSetup-kotlin:2.1.0") 行，替换为：
testImplementation("com.ninja-squad:DbSetup-kotlin:2.1.0")
testImplementation("com.ninja-squad:DbSetup:1.3.4")

说明：testImplementation作用域会保证依赖在测试全生命周期（编译、运行）对类加载器可见；补全核心DbSetup依赖是为了避免Gradle依赖解析时未自动传递引入核心包的问题。

2. 测试代码逻辑校准 #

现有测试类和Testcontainers的集成逻辑整体正确，仅需做少量适配即可正常运行：

• 保留现有的@DynamicPropertySource动态属性注册逻辑，Spring在加载这些属性后会自动将容器管理的DataSource指向Testcontainers启动的PostgreSQL实例，无需手动从容器获取连接，原来直接注入DataSource传给dbSetup()的写法是合规的。
• 建议将数据库准备逻辑和测试执行解耦，使用@BeforeEach注解标记统一的初始化入口，避免单测间的数据交叉污染：

@BeforeEach
fun initTestData() {
    prepareDatabase {
        // 按测试用例需求插入对应数据集
    }
}

• 确认flyway-core会在测试启动时自动执行迁移脚本，在Testcontainers的PostgreSQL实例中创建对应表结构，避免DbSetup执行插入操作时出现表不存在的异常。

3. 配置避坑提示 #

• 所有需要在测试运行阶段实际执行逻辑的测试类库，都不能使用testCompileOnly作用域声明，该作用域仅适用于编译期注解处理器等不需要在运行时加载的组件。
• 确认Testcontainers的PostgreSQL容器启动后，等待数据库完全就绪再连接，避免连接超时报错。

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