集成Navigation组件后Android项目出现module-info类构建失败问题
该构建报错的可行解决方案
先说清楚触发问题的核心原因:你引入的Navigation 2.3.3版本的依赖包,本身带了Java 9多版本jar结构的module-info.class模块描述文件,而项目里集成的老旧字节码插桩SDK(也就是执行transformClassesWithByteCodeTransform任务的插件,比如你引入的DeployGate 3.1这类年份很久的工具),对Java 9多版本jar的路径识别存在bug——会把原本的斜杠路径分隔符替换成点来匹配资源,导致你之前写的斜杠路径排除规则根本匹配不上目标文件,最终抛出找不到类的报错。
具体调整步骤
- 更换为全路径通配的packagingOptions排除规则
之前写的exclude "**/module-info.class"没效果,是因为老插件的路径识别逻辑和正常规则不一致,需要把所有可能的匹配形式都覆盖,不管插件把路径识别成斜杠分隔还是点分隔,都能把无用的模块文件排除出打包流程:packagingOptions { // 匹配多版本jar目录下的模块文件 exclude "/META-INF/versions/9/module-info.class" // 通配覆盖所有META-INF目录下的模块描述文件 exclude "META-INF/**/module-info.class" // 兜底匹配所有形式的模块类文件 exclude "**/*.module-info" // 遇到重复文件统一取第一个,避免多来源冲突 pickFirst "**/module-info.class" } - 删除完全冗余的不兼容Navigation依赖
从你贴的完整依赖配置来看,项目从头到尾没有集成任何Jetpack Compose的基础依赖,引入navigation-compose:1.0.0-alpha05属于照搬官方文档时多抄的配置——这个Compose导航包本身就内置了Java 9模块描述文件,是触发报错的高概率来源,直接删掉对应依赖行即可:
另外如果项目没有使用动态Feature模块分发的能力,// 删除这行,当前项目技术栈根本用不上 // implementation "androidx.navigation:navigation-compose:1.0.0-alpha05"navigation-dynamic-features-fragment这个依赖也可以直接删掉,减少不必要的依赖冲突。 - 匹配适配当前老旧依赖栈的Navigation版本
你项目当前的基础依赖版本(appcompat 1.0.2、lifecycle 2.1.0、老版GMS、GreenDao 1.3.7)本身是和早期Jetpack版本配套的,Navigation 2.3.3的版本基线要求更高的AGP和AndroidX依赖版本,和现有依赖栈兼容性差。可以直接把Navigation版本降级到2.2.2,这个版本的Navigation包没有内置Java 9模块描述文件,和老项目的适配性更好:def nav_version = "2.2.2" - 剩余冲突的排查方式
如果改完上述配置还是报错,就通过Gradle依赖树定位具体带模块文件的来源,在项目根目录执行命令导出完整debug运行时的依赖列表:
在生成的./gradlew app:dependencies --configuration debugRuntimeClasspath > deps_tree.txtdeps_tree.txt文件里搜索传递引入module-info.class的具体依赖,单独对该依赖加排除规则即可。
不用白费功夫调整全局Java编译版本,哪怕你把编译版本降到Java 8,只要jar包本身内嵌了Java 9的多版本目录,老旧的字节码处理插件就会识别异常,报错和项目使用的Java编译版本没有关系。
内容的提问来源于stack exchange,提问作者Michael
相关产品推荐
相关产品推荐

