Spring Boot+Gradle多模块项目依赖加载失败问题求助

遇到多模块项目里集成测试模块依赖加载失败的情况很常见，咱们从几个核心维度一步步排查：

1. 先确认集成测试模块的依赖声明是否正确 #

你的proj-integration-tests需要访问业务模块的代码和配置，首先得在它的build.gradle里正确引入必要依赖：

dependencies {
    // 根据测试场景选择：如果要测API接口，依赖proj-app；如果测业务逻辑，依赖proj-service
    implementation project(':proj-app')
    // implementation project(':proj-service')
    
    // Spring Boot集成测试必备依赖
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
    // 如果用到Testcontainers这类工具，补充对应依赖
    // testImplementation 'org.testcontainers:junit-jupiter'
}

注意：如果需要在编译时就能找到业务类，别用testRuntimeOnly，要用implementation或testImplementation来引入业务模块。

2. 处理spring-boot-gradle-plugin的特殊影响 #

因为proj-app用了这个插件，它默认生成的是可执行fat jar，这种jar的结构和普通依赖jar不一样，直接依赖会导致类找不到。有两种解决办法：

方案一：让proj-app同时生成普通jar和可执行jar #

在proj-app的build.gradle里添加配置，生成两个jar分别用于依赖和运行：

springBoot {
    mainClass = 'com.yourpackage.ProjApplication'
    // 启用普通jar（供其他模块依赖）
    jar {
        enabled = true
    }
    // 启用可执行jar（用于启动应用），加后缀区分
    bootJar {
        enabled = true
        archiveClassifier = 'app'
    }
}

这样proj-app会输出两个jar：proj-app-xxx.jar（普通依赖用）和proj-app-xxx-app.jar（可执行），集成测试模块依赖:proj-app时会自动选用普通jar。

方案二：在集成测试模块中指定依赖普通jar #

如果不想修改proj-app的配置，也可以在proj-integration-tests的build.gradle里明确指定依赖普通jar：

dependencies {
    implementation project(path: ':proj-app', configuration: 'archives')
    // 其他测试依赖...
}

3. 检查模块间的依赖传递是否正常 #

确保业务模块的依赖链是正确传递的：

• proj-service要依赖proj-model：implementation project(':proj-model')
• proj-app要依赖proj-service：implementation project(':proj-service')
  这样当集成测试模块依赖proj-app时，会自动获取proj-service和proj-model的依赖，不用重复声明。

4. 用Gradle命令验证依赖树 #

在根项目下执行以下命令，查看集成测试模块的依赖树，确认所需模块是否被正确拉取：

./gradlew :proj-integration-tests:dependencies

在输出里找implementation或testImplementation区块，检查:proj-app、:proj-service这些模块是否存在，有没有缺失的依赖。

5. 检查测试类的包结构与注解 #

如果依赖配置都没问题但还是找不到类，可能是测试类的包结构或注解有问题：

• 尽量让测试类的包结构和业务类保持一致，或者在测试类上用@ComponentScan指定要扫描的包
• 集成测试类要使用合适的Spring注解，比如@SpringBootTest（启动完整上下文）或@WebMvcTest（仅测试API层）

举个典型的集成测试类示例：

package com.yourpackage;

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import com.yourpackage.service.SomeService;

@SpringBootTest(classes = ProjApplication.class)
public class SampleIntegrationTest {

    @Autowired
    private SomeService someService;

    @Test
    void testBusinessLogic() {
        // 编写测试逻辑
    }
}

如果按上面的步骤排查后还是有问题，可以把proj-integration-tests的build.gradle内容和具体的错误日志贴出来，这样能更精准定位问题。

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