Jetpack Compose中使用枚举+NavHost带参数导航报错求助

问题场景 #

我尝试在Jetpack Compose中用枚举类实现带参数的导航，却触发了以下错误：

java.lang.IllegalArgumentException: No enum constant com.example.basiccounterapp.ui.CounterAppScreen.CountScreen/{counterId

相关代码如下：

枚举类定义 #

enum class CounterAppScreen(@StringRes val title: Int){
    MainScreen(title = R.string.main_screen),
    CountScreen(title = R.string.counter_screen)
}

NavHost路由注册 #

composable(
    "${CounterAppScreen.CountScreen.name}/{counterId}",
    arguments = listOf(
        navArgument("counterId"){type = NavType.IntType}
    )
)

点击跳转代码 #

Text(
    text = counterInfo.count.toString(),
    modifier = Modifier
        .clickable {
            navController.navigate("${CounterAppScreen.CountScreen.name}/${counterInfo.id}")
        },
    style = MaterialTheme.typography.displayLarge
)

问题原因及解决方法 #

错误核心是：导航框架解析路由时，误将CountScreen/{counterId}当作枚举常量名去匹配，而你的枚举类里根本没有这个名称的常量，自然报错。

正确的做法是把路由规则（包括带参数的格式）封装到枚举类中，避免硬编码拼接字符串：

1. 修改枚举类，新增路由属性 #

给每个枚举常量定义对应的路由字符串，把带参数的规则直接写在枚举里：

enum class CounterAppScreen(@StringRes val title: Int, val route: String){
    MainScreen(title = R.string.main_screen, route = "main_screen"),
    CountScreen(title = R.string.counter_screen, route = "count_screen/{counterId}")
}

2. 更新NavHost的路由注册 #

直接使用枚举的route属性，不用再手动拼接：

composable(
    route = CounterAppScreen.CountScreen.route,
    arguments = listOf(
        navArgument("counterId"){type = NavType.IntType}
    )
) { backStackEntry ->
    // 从回退栈中获取参数
    val counterId = backStackEntry.arguments?.getInt("counterId") ?: 0
    // 渲染目标页面
    CountScreen(counterId = counterId)
}

3. 优化跳转代码，规范参数拼接 #

跳转时需要生成带实际参数的完整路由，建议给枚举类添加专用方法处理参数拼接，避免拼写错误：

// 给枚举类添加扩展方法，通用处理参数拼接
fun CounterAppScreen.withArgs(vararg args: String): String {
    return buildString {
        append(route)
        args.forEach { arg ->
            append("/$arg")
        }
    }
}

// 或者针对CountScreen写专用方法，更直观
fun CounterAppScreen.CountScreen.withCounterId(counterId: Int): String {
    return "count_screen/$counterId"
}

然后在点击事件中使用：

Text(
    text = counterInfo.count.toString(),
    modifier = Modifier
        .clickable {
            // 两种方式二选一
            navController.navigate(CounterAppScreen.CountScreen.withCounterId(counterInfo.id))
            // navController.navigate(CounterAppScreen.CountScreen.withArgs(counterInfo.id.toString()))
        },
    style = MaterialTheme.typography.displayLarge
)

额外优化：避免参数名硬编码 #

可以把参数名定义成常量，彻底杜绝拼写错误：

const val ARG_COUNTER_ID = "counterId"

enum class CounterAppScreen(@StringRes val title: Int, val route: String){
    MainScreen(title = R.string.main_screen, route = "main_screen"),
    CountScreen(title = R.string.counter_screen, route = "count_screen/{$ARG_COUNTER_ID}")
}

// 注册路由时用常量
navArgument(ARG_COUNTER_ID){type = NavType.IntType}

// 获取参数时用常量
val counterId = backStackEntry.arguments?.getInt(ARG_COUNTER_ID) ?: 0

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