Gradle多模块项目中为特定模块排除指定依赖的方法

问题背景 #

我负责将公司多模块Gradle项目从Mockito v1迁移至v3，已完成以下依赖升级/新增：

• mockito-core：从1.10.19升级到3.12.4，同时新增mockito-inline 3.12.4
• powermock-api-mockito：从1.6.6升级为powermock-api-mockito2 2.0.9
• powermock-api-support：升级至2.0.9
• 新增ByteBuddy支持：byte-buddy 1.11.13、byte-buddy-agent 1.11.13

修复近500个测试文件后遇到核心问题：

• 某模块因需要Mock第三方库的final类，必须引入mockito-inline才能通过测试
• 其余模块仅依赖mockito-core即可正常运行

我希望在根build.gradle中保留mockito-core的全局定义，同时为特定模块排除不必要的Mockito依赖，暂不通过重写测试来兼容（耗时过长）。曾尝试以下配置但无效：

testImplementation("org.mockito:mockito-inline:3.12.4") {
    exclude group: 'org.mockito', module: 'mockito-core'
}

该模块仍会引入mockito-core。目前根build.gradle已强制指定版本避免与PowerMock冲突：

// Force 'org.mockito:mockito-core:3.12.4' to avoid conflicts with Powermock's Mockito 3.3.3
force libraries.mockito_core
force libraries.mockito_inline

可行解决方法 #

方案1：模块级精准排除+全局依赖管理 #

根build.gradle配置

在subprojects块中全局引入mockito-core，并保留版本强制：

subprojects {
    dependencies {
        // 给所有模块默认引入mockito-core
        testImplementation libraries.mockito_core
        // 其他全局测试依赖...
    }

    configurations.all {
        // 强制版本，避免PowerMock引入冲突版本
        force libraries.mockito_core, libraries.mockito_inline
    }
}

目标模块build.gradle配置

在需要mockito-inline的模块中，先排除默认的mockito-core，再引入mockito-inline：

// 从测试依赖中完全排除mockito-core
configurations.testImplementation {
    exclude group: 'org.mockito', module: 'mockito-core'
}

dependencies {
    // 引入mockito-inline
    testImplementation libraries.mockito_inline

    // 确保PowerMock不引入冲突的Mockito依赖
    testImplementation(libraries.powermock_api_mockito2) {
        exclude group: 'org.mockito'
    }
    testImplementation(libraries.powermock_api_support)
}

方案2：利用Gradle依赖约束控制 #

在根build.gradle中通过约束统一版本，模块按需选择依赖：

allprojects {
    dependencies {
        constraints {
            // 全局约束mockito版本
            testImplementation(libraries.mockito_core)
            testImplementation(libraries.mockito_inline)
        }
    }
}

• 普通模块直接使用mockito-core：

dependencies {
    testImplementation libraries.mockito_core
}

• 目标模块替换为mockito-inline并排除传递依赖：

dependencies {
    testImplementation(libraries.mockito_inline) {
        exclude group: 'org.mockito', module: 'mockito-core'
    }

    // 隔离PowerMock与Mockito的依赖关联
    testImplementation(libraries.powermock_api_mockito2) {
        exclude group: 'org.mockito'
    }
}

方案3：Gradle 7+变体选择（推荐） #

Mockito从v3开始提供了变体支持，mockito-inline是mockito-core的替代变体，可直接在模块中指定使用：

dependencies {
    testImplementation('org.mockito:mockito-core') {
        capabilities {
            // 要求使用mockito-inline变体替代mockito-core
            requireCapability('org.mockito:mockito-inline')
        }
    }
}

此方式无需手动排除依赖，Gradle会自动替换为mockito-inline，同时保留全局版本强制的效果。

验证方法 #

执行以下命令查看目标模块的测试运行时依赖树，确认mockito-core已被排除：

./gradlew :your-target-module:dependencies --configuration testRuntimeClasspath

检查输出中是否仅存在mockito-inline，无mockito-core条目。

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