运行Android测试时出现META-INF/LGPL2.1文件重复冲突如何解决

问题根因 #

这是Android构建阶段的资源合并冲突问题：jna和jna-platform两个依赖包内存在相同路径的许可文件META-INF/LGPL2.1，构建工具无法判定保留版本，触发编译失败。
两个冲突的依赖是测试依赖间接引入的，上游来源是espresso-contrib，因此在直接声明的依赖列表中无法看到这两个包。

排查步骤 #

• 执行Gradle命令查看测试环境的依赖树，定位冲突依赖的上游来源：

  ./gradlew :app:dependencies --configuration androidTestDebugRuntimeClasspath | grep -A 10 -B 10 jna
  

  运行后可确认androidx.test.espresso:espresso-contrib:3.4.0是引入jna的直接依赖。
• 验证冲突文件类型：本次冲突的是开源许可文件，不属于运行必需的代码或资源，可通过排除规则处理。

解决方法 #

方法1：配置打包规则排除冲突文件（最快生效，推荐） #

在app模块的build.gradle文件的android配置块中添加packagingOptions规则，直接排除冲突的许可文件即可，不会影响测试功能：

android {
    // 保留原有配置不变
    packagingOptions {
        exclude 'META-INF/LGPL2.1'
        // 也可以选择保留首个遇到的该文件，效果相同
        // pickFirst 'META-INF/LGPL2.1'
    }
}

修改后同步Gradle，重新运行测试即可正常编译。

方法2：排除espresso-contrib的jna传递依赖 #

如果你不需要使用espresso-contrib中依赖jna的功能（如抽屉布局交互相关逻辑），可以在引入依赖时直接排除jna传递依赖，从根源消除冲突：

androidTestImplementation ('androidx.test.espresso:espresso-contrib:3.4.0') {
    exclude group: 'net.java.dev.jna'
}

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