Navigation Graph部分Action无法解析问题求助

问题背景 #

项目基于Navigation组件2.5.3版本开发，包含多个导航图，多数Action可正常调用，但有4个特定Action在构建APK时触发Unresolved reference: action...错误。代码调用和导航图配置逻辑与正常Action一致，排除常规代码错误可能，怀疑是缓存或组件异常导致。

代码调用示例 #

findNavController().navigate(MyAppClassDirections.actionTasksToFooClassDetails(
   item.requestNumber,
   item.id.toString(),
   ActionCode.Inbox // 枚举类
))

对应导航图Action声明 #

<action
  android:id="@+id/action_tasks_to_foo_class_details"
  app:destination="@id/my_other_dest"
  app:enterAnim="@anim/slide_in_left"
  app:exitAnim="@anim/slide_out_right"
  app:popEnterAnim="@anim/pop_enter"
  app:popExitAnim="@anim/pop_exit">
    <argument
       android:name="requestNumber"
       app:argType="string" />

    <argument
       android:name="id"
       app:argType="string" />

    <argument
       android:name="actionCode"
       app:argType="com.myapp.data.ActionCode" />
</action>

已尝试无效操作 #

• 多次执行Invalidate Cache并重启Android Studio
• 多次Clean/Rebuild项目
• 删除并重新添加相关类
• 修改Action的id

排查解决思路 #

1. 检查枚举类的配置与导入 #

• 确认ActionCode枚举类的访问修饰符为public，未被设置为包级私有
• 核对导航图中argType的枚举类全路径，确保包名、类名无拼写错误（注意大小写）
• 检查代码中ActionCode的导入语句，确认未导入错误的类

2. 检查导航图的引用与结构 #

• 若该Action所在导航图通过<include>标签被其他导航图引入，确认引入路径正确，无重复ID或资源冲突
• 确认导航图文件存放于res/navigation目录下，未误放置到其他资源目录

3. 清理Safe Args生成缓存并检查注解配置 #

• 手动删除项目根目录下build/generated/source/navigation-args文件夹，该目录为Safe Args生成代码的存储位置，旧缓存文件可能导致异常
• 检查Module级build.gradle，确保正确引入Navigation注解处理器：

  dependencies {
    def nav_version = "2.5.3"
    implementation "androidx.navigation:navigation-fragment-ktx:$nav_version"
    implementation "androidx.navigation:navigation-ui-ktx:$nav_version"
    kapt "androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version"
  }
  

• 检查Project级build.gradle，确认已应用Navigation插件：

  plugins {
    id 'androidx.navigation.safeargs.kotlin' version '2.5.3' apply false
  }
  

4. 核对Action参数的匹配度 #

• 确认代码中调用Action时传入的参数数量、类型、顺序，与导航图中<argument>声明完全一致
• 例如导航图中三个参数依次为string、string、枚举，需确保代码中未传入类型不匹配的参数（如将id传入数字而非字符串）

5. 检查插件与库版本一致性 #

• 确认Android Studio中Navigation插件版本与项目依赖的Navigation库版本（2.5.3）一致，版本不匹配可能导致代码生成异常
• 可通过File > Settings > Plugins > Android Navigation查看并更新插件

6. 尝试调整Navigation库版本 #

• 2.5.3版本存在已知的Safe Args生成Bug，可临时升级到2.5.4或降级到2.5.2，同步项目后重新Clean/Rebuild，验证问题是否解决

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