如何通过Maven Shade插件自动Shade Kafka Clients 0.11的传递依赖？

要无需逐个手动指定就把KC-0.11及其所有传递依赖打包进你的Jar，关键是正确配置Maven Shade插件的<dependencySet>，让它自动包含目标依赖的传递依赖。这里是具体的配置示例：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-shade-plugin</artifactId>
      <version>3.4.1</version> <!-- 使用最新稳定版 -->
      <executions>
        <execution>
          <phase>package</phase>
          <goals>
            <goal>shade</goal>
          </goals>
          <configuration>
            <!-- 核心：重定位KC-0.11及其依赖的包路径，彻底避免与KC-0.8冲突 -->
            <relocations>
              <relocation>
                <pattern>org.apache.kafka</pattern>
                <shadedPattern>com.yourinfra.kafka.v0_11</shadedPattern> <!-- 换成你的自定义前缀 -->
              </relocation>
              <!-- 如果KC-0.11的传递依赖也有与KC-0.8重叠的包，同样需要添加重定位规则 -->
            </relocations>

            <!-- 配置只包含KC-0.11及其所有传递依赖 -->
            <dependencySets>
              <dependencySet>
                <includes>
                  <include>org.apache.kafka:kafka-clients:0.11.*</include>
                </includes>
                <!-- 显式声明自动包含传递依赖（默认是true，显式写更清晰） -->
                <useTransitiveDependencies>true</useTransitiveDependencies>
                <!-- 过滤掉非必要的传递依赖（比如provided scope的依赖） -->
                <useTransitiveFiltering>true</useTransitiveFiltering>
              </dependencySet>
            </dependencySets>

            <!-- 生成简化POM，避免把Shade的依赖传递给项目X -->
            <createDependencyReducedPom>true</createDependencyReducedPom>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

这个配置会自动解析KC-0.11的所有传递依赖，把它们和KC-0.11本身一起打包到你的Jar里，同时通过包路径重定位，完全隔离KC-0.11和KC-0.8的类，避免冲突。

你说得对，从功能完整性角度，Shade一个依赖时确实需要它的传递依赖才能正常工作，但默认不这么“强制”是因为Maven Shade插件需要兼顾灵活性：

• 避免Jar体积膨胀：如果默认打包所有传递依赖，你的Jar可能会包含很多项目不需要的依赖（比如测试依赖、provided scope的依赖），导致Jar体积过大。
• 把依赖控制权交给用户：有些场景下，用户可能希望某些传递依赖由宿主项目（比如你的项目X）提供，而不是打包进Shaded Jar。比如如果项目X已经依赖了某个版本的SLF4J，重复打包反而会浪费空间。
• 防止意外冲突：自动包含所有传递依赖可能会引入宿主项目中已经存在的其他版本依赖，反而引发新的冲突——虽然Shade是为了解决冲突，但盲目打包所有依赖可能会弄巧成拙。

不过需要注意：默认情况下，Shade插件会打包项目中所有compile和runtime scope的依赖（包括传递依赖），除非你显式配置了排除。如果你之前只Shade了KC-0.11本身，可能是因为你的配置里限制了只包含kafka-clients这个artifact，而没有包含它的传递依赖——上面的<dependencySet>配置就是解决这个问题的关键，它明确告诉插件“包含这个依赖及其所有传递依赖”。

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