Kotlin与Java类使用ProGuard失败，无法生成签名APK

嘿，你遇到的这个Duplicate zip entry [com/xyztech/models/Sender.class]错误我之前帮不少开发者搞定过——核心原因就是ProGuard在处理打包文件时，发现同一个类存在多份拷贝，直接卡壳了。下面给你几个实用的排查和解决思路：

1. 先查依赖库的重复引用 #

• 打开你的模块build.gradle文件，先看看有没有重复引入的依赖：比如同一个库既加了远程依赖，又手动导入了本地的aar/jar包；或者同时引入了不同版本的同一款库。
• 用这个命令生成依赖树，精准定位重复项：

  ./gradlew app:dependencies --configuration prodReleaseCompileClasspath
  

  （把app换成你的模块名）找到包含Sender.class的库，如果发现重复，就用exclude语法删掉多余的引用：

  implementation('com.example:some-library:1.0') {
      exclude group: 'com.xyztech', module: 'models'
  }
  

2. 清理构建缓存试试 #

• 有时候旧的构建缓存会残留冗余文件，导致重复问题。执行下面的命令彻底清理：

  ./gradlew clean
  rm -rf ~/.gradle/caches
  

  清理完重新打包，很多时候缓存问题解决了，错误也就消失了。

3. 检查项目内的类重复定义 #

• 错误里提到了/Users/xyztech-Android/app/build/tmp/kotlin-classes/prodRelease这个路径，说明Kotlin编译输出的类和其他地方的重复了。你可以检查一下：
  • 项目里是不是有多个模块（比如主APP模块和某个子模块）都定义了com.xyztech.models.Sender这个类？如果有，得合并或者删掉重复的类文件。
  • 有没有不小心把同一个类的文件复制到了不同目录下？比如main目录和debug目录里都有这个类？

4. 临时用ProGuard规则跳过重复（不推荐长期用） #

• 如果一时找不到重复根源，可以先在proguard-rules.pro里加规则让ProGuard忽略这个重复：

  -dontwarn com.xyztech.models.Sender
  -keep class com.xyztech.models.Sender { *; }
  

  注意：这只是临时救急的办法，最好还是找到重复的根源彻底解决，不然后续可能会出现其他奇怪的运行时问题。

5. 用packagingOptions定位或处理重复 #

• 在build.gradle的android块里配置packagingOptions，要么让打包工具选第一个找到的类，要么开启严格模式明确看到重复的位置：

  android {
      packagingOptions {
          // 选择第一个找到的Sender.class，跳过重复的
          pickFirst 'com/xyztech/models/Sender.class'
          // 或者开启严格模式，打包时直接提示所有重复文件的位置
          // strictDuplicateCheck true
      }
  }
  

  开启strictDuplicateCheck能帮你精准找到哪两个地方出现了重复，方便彻底解决问题。

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