Gradle多层级依赖替换问题：自定义Tomcat嵌入包版本不生效

1. dependencySubstitution的用法及配置位置是否正确？ #

正确的配置需在项目根目录的build.gradle中，针对全局配置（或特定配置）设置替换规则，示例代码如下：

configurations.all {
    resolutionStrategy.dependencySubstitution {
        // 替换tomcat-embed-el官方版本为自定义版本
        substitute module('org.apache.tomcat.embed:tomcat-embed-el:9.0.65') 
            with module('org.apache.tomcat.embed:tomcat-embed-el:9.0.65.CUSTOM')
        // 替换tomcat-embed-websocket官方版本为自定义版本
        substitute module('org.apache.tomcat.embed:tomcat-embed-websocket:9.0.65') 
            with module('org.apache.tomcat.embed:tomcat-embed-websocket:9.0.65.CUSTOM')
    }
}

同时需确认：

• 私有仓库已正确配置在repositories块中，确保Gradle能拉取到自定义版本包
• 无其他依赖直接声明原9.0.65版本，避免替换规则被覆盖

2. dependencySubstitution是否支持间接依赖替换？ #

完全支持。该功能的核心就是处理依赖树中所有层级的依赖替换，无论直接依赖还是间接传递依赖。如果替换未生效，大概率是版本号排序问题：Gradle默认版本冲突策略是取最高版本，但9.0.65.CUSTOM这种带后缀的版本号，在Gradle语义化版本排序逻辑中可能不被识别为比9.0.65更高的版本，导致原版本仍被选中，这种情况需明确指定替换规则而非依赖自动排序。

3. 无需fork所有依赖，能否强制Gradle全局仅使用自定义版本？ #

可以，有两种更直接的实现方式：

方式一：使用resolutionStrategy.force强制版本 #

直接强制Gradle在整个项目中使用指定自定义版本，忽略依赖树中的其他版本：

configurations.all {
    resolutionStrategy.force(
        'org.apache.tomcat.embed:tomcat-embed-el:9.0.65.CUSTOM',
        'org.apache.tomcat.embed:tomcat-embed-websocket:9.0.65.CUSTOM'
    )
}

方式二：覆盖Spring Boot的依赖管理版本 #

由于是Spring Boot项目，Spring Boot通过dependency management统一管控第三方依赖版本，只需在build.gradle中覆盖tomcat的版本变量即可：

ext['tomcat.version'] = '9.0.65.CUSTOM'

这种方式更简洁，所有依赖tomcat的Spring Boot Starter（如spring-boot-starter-tomcat）都会自动使用该自定义版本，无需逐个替换模块。

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