You need to enable JavaScript to run this app. 集成Navigation组件后Android项目出现module-info类构建失败问题
优惠活动
大模型
产品
解决方案
定价
更多

集成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模块描述文件,是触发报错的高概率来源,直接删掉对应依赖行即可:
    // 删除这行,当前项目技术栈根本用不上
    // implementation "androidx.navigation:navigation-compose:1.0.0-alpha05"
    
    另外如果项目没有使用动态Feature模块分发的能力,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.txt
    
    在生成的deps_tree.txt文件里搜索传递引入module-info.class的具体依赖,单独对该依赖加排除规则即可。

不用白费功夫调整全局Java编译版本,哪怕你把编译版本降到Java 8,只要jar包本身内嵌了Java 9的多版本目录,老旧的字节码处理插件就会识别异常,报错和项目使用的Java编译版本没有关系。

内容的提问来源于stack exchange,提问作者Michael

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.02 21:06:03