Gradle中OpenTelemetry传递依赖版本管控与过滤方案咨询

1. Gradle传递依赖的过滤粒度 #

Gradle对传递依赖的控制粒度可以精确到单个依赖项的特定传递分支，支持按groupId、artifactId、版本，甚至依赖路径（即某个依赖的上游依赖链）来过滤、替换或强制版本。你可以针对某一个模块的某一条传递依赖单独设置规则，完全不影响其他依赖链的版本选择。

2. 关于io.opentelemetry.api.internal.InstrumentationUtil类 #

• 该类确实属于opentelemetry-instrumentation-api模块。
• 它在OpenTelemetry 1.28.0版本中被添加，用于封装内部工具方法。
• 在OpenTelemetry 2.0.0版本中被移除，因为2.x版本重构了内部API体系，相关功能被合并到其他类中。

你的ClassNotFoundException问题本质是依赖链中同时存在1.x和2.x的OpenTelemetry模块：比如依赖d用的1.37.0包含这个类，而依赖c用的2.7.0已经移除了它，反之亦然。

3. 针对不同传递依赖单独指定版本的解决方案 #

针对你描述的模块依赖链（a→b→c依赖2.7.0，a→b→d依赖1.37.0），可以用以下几种Gradle配置实现精准版本控制：

方案一：通过依赖路径匹配强制版本 #

利用Gradle的resolutionStrategy.eachDependency，根据依赖的上游路径判断，给不同来源的OpenTelemetry依赖设置对应版本：

configurations.all {
    resolutionStrategy.eachDependency { DependencyResolveDetails details ->
        def requested = details.requested
        // 匹配所有OpenTelemetry模块
        if (requested.group == 'io.opentelemetry') {
            // 当依赖来自模块c（替换为你的c模块实际坐标：groupId:artifactId）
            if (details.path.contains('com.example:c')) {
                details.useVersion '2.7.0'
                details.because '模块c依赖OpenTelemetry 2.7.0'
            }
            // 当依赖来自模块d（替换为你的d模块实际坐标）
            else if (details.path.contains('com.example:d')) {
                details.useVersion '1.37.0'
                details.because '模块d依赖OpenTelemetry 1.37.0'
            }
        }
    }
}

方案二：拆分配置隔离不同版本 #

如果模块c和d的代码逻辑相互独立，可以将它们的依赖拆分到不同配置中，分别排除冲突的传递依赖后手动添加对应版本：

// 定义两个继承自implementation的配置，分别对应c和d的依赖链
configurations {
    cImpl.extendsFrom implementation
    dImpl.extendsFrom implementation
}

dependencies {
    // 给cImpl配置添加模块b，排除所有OpenTelemetry传递依赖
    cImpl('com.example:b:1.0.0') {
        exclude group: 'io.opentelemetry'
    }
    // 给dImpl配置添加模块b，同样排除OpenTelemetry传递依赖
    dImpl('com.example:b:1.0.0') {
        exclude group: 'io.opentelemetry'
    }

    // 给cImpl添加2.7.0版本的OpenTelemetry依赖
    cImpl 'io.opentelemetry:opentelemetry-api:2.7.0'
    cImpl 'io.opentelemetry:opentelemetry-instrumentation-api:2.7.0'
    // 给dImpl添加1.37.0版本的OpenTelemetry依赖
    dImpl 'io.opentelemetry:opentelemetry-api:1.37.0'
    dImpl 'io.opentelemetry:opentelemetry-instrumentation-api:1.37.0'
}

注意事项 #

• OpenTelemetry 1.x和2.x存在API不兼容，这种版本共存的方式可能带来类加载风险，建议仅在模块c和d的代码完全隔离（无交叉调用）时使用。
• 尽量优先推动依赖模块（c或d）升级到兼容的OpenTelemetry版本，这是长期解决冲突的最优方案。

内容的提问来源于stack exchange，提问作者jactor-rises