应用类路径不应引入未使用依赖：Java SDK依赖传递问题

核心问题分析 #

你的SDK核心模块（keploy-sdk）默认将所有依赖声明为compile scope，这会导致所有依赖都会传递给引入SDK的客户端项目——即便客户端没有实际使用这些依赖，它们也会被导入到应用类路径中，造成依赖冗余。

针对性解决方案 #

1. 调整依赖Scope #

对于SDK内部实现专用、客户端无需直接依赖的库，可将其Scope设置为provided或runtime：

• provided：表示依赖由运行环境提供，不会传递给客户端，适合仅SDK编译时需要、运行时由容器/客户端环境兜底的依赖。
• runtime：表示依赖仅在运行时需要，编译阶段无需引入，同样不会强制传递给客户端（客户端若需使用可自行显式引入）。

比如你提到的ApacheClient依赖，若仅用于SDK内部拦截逻辑，客户端无需调用，可修改为：

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>x.x.x</version>
    <scope>provided</scope>
</dependency>

2. 拆分SDK模块（推荐） #

基于你已有的多模块架构，可将可选功能拆分为独立子模块：

• 核心基础模块：包含SDK核心API与必要依赖，是客户端必须引入的基础模块。
• 可选功能模块：比如ApacheClient集成、OkHttp集成等专项模块，客户端仅在需要对应功能时才引入该子模块。

这种方式让客户端按需引入，从根源上避免冗余依赖被导入。

3. 优化Maven Shade Plugin配置 #

你当前使用了maven-shade-plugin但设置了createDependencyReducedPom=false，这会保留所有依赖在发布的POM中。可调整配置生成精简POM，仅保留客户端真正需要的依赖：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.2.4</version>
    <configuration>
        <createDependencyReducedPom>true</createDependencyReducedPom>
        <!-- 可选：过滤冗余文件，避免冲突 -->
        <filters>
            <filter>
                <artifact>*:*</artifact>
                <excludes>
                    <exclude>META-INF/*.SF</exclude>
                    <exclude>META-INF/*.DSA</exclude>
                    <exclude>META-INF/*.RSA</exclude>
                </excludes>
            </filter>
        </filters>
    </configuration>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
        </execution>
    </executions>
</plugin>

设置createDependencyReducedPom=true后，Maven会生成dependency-reduced-pom.xml，其中仅保留SDK暴露给客户端的依赖，而非所有内部依赖，发布时使用该精简POM即可。

4. 标记可选依赖 #

对于非核心的功能依赖，可添加optional=true标记，这样客户端不会自动继承该依赖，需要时必须显式引入：

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>x.x.x</version>
    <optional>true</optional>
</dependency>

针对你当前POM的具体调整建议 #

观察你提供的keploy-sdk POM，byte-buddy-agent、grpc-netty-shaded等依赖若仅为SDK内部使用，客户端无需直接调用，可按如下方式调整：

<!-- 示例调整：标记为可选依赖 -->
<dependency>
    <groupId>net.bytebuddy</groupId>
    <artifactId>byte-buddy-agent</artifactId>
    <version>1.12.14</version>
    <optional>true</optional>
</dependency>
<dependency>
    <groupId>io.grpc</groupId>
    <artifactId>grpc-netty-shaded</artifactId>
    <version>1.49.2</version>
    <optional>true</optional>
</dependency>

内容的提问来源于stack exchange，提问作者Dr Drake Ramoray