Github Action执行ANT构建的Java项目时外部jar包读取报错如何解决

核心根因 #

error in opening zip file报错本质是Github Actions运行环境中读取到的jar包出现损坏，或是依赖路径不匹配，和ANT本身的配置逻辑无关，本地运行正常是因为本地的jar包和路径都符合预期。

具体解决步骤 #

• 修复Git二进制文件识别规则（优先尝试）
  Git默认的自动换行符转换逻辑会误将部分jar包识别为文本文件，在提交到仓库时修改二进制内容，导致拉取到CI环境后文件损坏。

  1. 在项目根目录新建.gitattributes文件，添加如下规则强制所有jar包按二进制文件处理：

  *.jar binary
  

  2. 提交该文件到仓库后，重新上传一遍本地完好的jar包覆盖仓库中已损坏的版本，重新运行workflow即可。

• 修正ANT依赖路径配置
  你提到依赖存放在project/lib目录，但当前ANT配置的classpath读取的是根目录下的lib文件夹，和实际路径不匹配。

  1. 可以先在workflow的ANT步骤前添加目录结构打印步骤，确认CI环境的实际文件路径：

  - name: 打印目录结构
    run: ls -R
  

  2. 根据打印结果修改ANT的classpath配置为正确路径，比如如果lib在project子目录下，修改为：

  <path id="classpath">
      <fileset dir="project/lib">
          <include name="*.jar" />
      </fileset>
  </path>
  

• 其他兼容修复

  1. 升级老旧的checkout Action版本，避免旧版本拉取二进制文件时的校验异常：

  - uses: actions/checkout@v4
  

  2. 增加文件权限修正步骤，避免CI环境文件权限不足导致无法读取jar：

  - name: 修正jar包权限
    run: chmod 644 lib/*.jar
  

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