Windows环境下如何定位Maven仓库损坏Jar文件并重新安装？

这个问题我在日常开发里碰到过好多次，百分百是Maven本地仓库（就是.m2/repository）里的Jar包损坏了——毕竟网络波动、中途中断下载、磁盘写入异常这些情况都可能搞坏这些压缩包。下面给你一套实操性强的解决步骤：

要解决问题，得先精准找到哪个Jar出了问题，有两个实用方法：

• 查看Maven调试日志：运行mvn clean install -X（-X是开启调试模式，会输出详细日志），在输出里搜索包含invalid CEN header的行，后面跟着的绝对路径就是损坏的Jar包位置，比如~/.m2/repository/com/google/guava/guava/30.1-jre/guava-30.1-jre.jar，直接定位到这个文件就行。
• 手动校验Jar完整性：如果日志没明确指出，你可以用命令行工具检查。在Linux/macOS下用unzip -t <Jar文件绝对路径>，Windows下用jar tf <Jar文件绝对路径>，如果命令输出报错，那这个Jar肯定是损坏的。

找到损坏的Jar后，按以下方式修复：

• 直接删除损坏的依赖目录：找到损坏Jar所在的整个版本目录（比如上面的~/.m2/repository/com/google/guava/guava/30.1-jre/），直接删掉这个目录，然后重新运行mvn clean install，Maven会自动重新下载这个依赖。
• 强制重新下载单个依赖：如果你不想删除整个目录，可以用Maven的专用命令指定重新下载某个依赖：

  mvn dependency:purge-local-repository -DmanualInclude=com.google.guava:guava:30.1-jre
  

  这里的com.google.guava:guava:30.1-jre是依赖的groupId:artifactId:version，替换成你自己的依赖信息就行。
• 清理整个本地仓库（极端情况）：如果很多Jar都损坏了，或者实在找不到具体哪个，你可以直接删除整个.m2/repository文件夹，再运行mvn clean install让Maven重新下载所有依赖——不过这个方法耗时较长，建议万不得已再用。

为了避免以后再踩这个坑，可以做这几个配置：

• 开启Maven校验功能：在你的Mavensettings.xml里添加以下配置，让Maven自动校验依赖的完整性，一旦发现损坏就会重新下载：

  <settings>
    <profiles>
      <profile>
        <id>checksum-verify</id>
        <activation>
          <activeByDefault>true</activeByDefault>
        </activation>
        <properties>
          <maven.checksum.verify>true</maven.checksum.verify>
        </properties>
      </profile>
    </profiles>
  </settings>
  

• 避免中断Maven下载：下载依赖时尽量不要强制终止Maven进程，不然很容易导致Jar包下载不完整。
• 配置稳定的镜像仓库：如果官方Maven仓库下载不稳定，可以配置国内的镜像（比如阿里云镜像），减少下载失败和损坏的概率。

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