传递依赖致构建失败：Maven Shade插件打包报错求助

嘿，这个错误我之前帮同事排查过，大概率是本地Maven仓库里的依赖JAR损坏了——毕竟invalid LOC header是ZIP文件的本地头损坏导致的，和你排除传递依赖的操作关系不大，咱们一步步来解决：

先从最常见的原因入手：清理损坏的依赖 #

这个方法亲测有效，先强制Maven重新下载所有依赖：

• 执行这条命令，清理项目并强制更新依赖：

  mvn clean install -U
  

  这里的-U参数会让Maven忽略本地缓存，重新拉取所有依赖，把可能损坏的JAR替换掉。
• 如果还是不行，就手动去本地仓库（默认是~/.m2/repository）找最近更新过的依赖，或者错误栈里提到的依赖，直接删掉对应的文件夹，再重新跑mvn install。

检查Shade插件的配置是否有问题 #

有时候Shade插件的复杂配置（比如资源过滤、冲突处理）也会触发这个错误，你可以先简化配置，确保基础打包正常：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-shade-plugin</artifactId>
      <version>3.4.1</version> <!-- 尽量用最新稳定版，避免旧版bug -->
      <executions>
        <execution>
          <phase>package</phase>
          <goals>
            <goal>shade</goal>
          </goals>
          <configuration>
            <transformers>
              <!-- 先只保留主类配置，去掉其他复杂转换 -->
              <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                <mainClass>com.yourpackage.YourMainClass</mainClass> <!-- 替换成你的主类 -->
              </transformer>
            </transformers>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

如果简化后能正常打包，再慢慢加回你之前的过滤、排除等配置，逐一排查哪个配置出了问题。

排查特定依赖 #

要是上面两步都没解决，那就用“二分法”排查：逐步注释掉POM里的依赖，每次打包测试，找到那个导致错误的依赖。找到后，要么删除本地仓库里该依赖的文件夹重新下载，要么换个版本试试——有些依赖的特定版本本身就有损坏的情况。

另外，也可以检查下你的Maven版本，尽量用3.8.x以上的稳定版，旧版本Maven在处理某些依赖时可能会有兼容性问题。

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