Compose Destinations中Uri参数单元测试问题的解决方案

问题背景

在使用Compose Destinations导航库时，开发者可能会遇到一个常见的单元测试问题：当测试包含Uri类型参数的导航目标时，会抛出NullPointerException异常。这个问题的根源在于Android框架依赖与JVM单元测试环境之间的不兼容性。

错误现象

在单元测试中尝试创建包含Uri参数的导航目标时，会出现如下错误堆栈：

java.lang.NullPointerException: obtain(...) must not be null
    at DefaultParcelableNavTypeSerializer.toBase64
    at DefaultParcelableNavTypeSerializer.toRouteString
    at UriNavType.serializeValue

问题原因分析

1. Android依赖问题：Uri是Android特有的Parcelable类型，在纯JVM单元测试环境中无法获取Android框架支持
2. 序列化机制：Compose Destinations默认使用Parcelable序列化Android特有类型
3. 测试环境限制：单元测试运行在JVM而非Android运行时环境

解决方案

方案一：使用kotlinx.serialization替代Parcelable

1. 修改导航参数定义，使用@Serializable注解替代Parcelable
2. 添加kotlinx-serialization依赖
3. 确保导航目标类实现了Serializable接口

@Serializable
data class MyNavArgs(
    @Serializable(with = UriSerializer::class)
    val uriParam: Uri
)

@Composable
@Destination
fun MyScreen(
    navArgs: MyNavArgs
) {
    // 屏幕内容
}

方案二：使用Mock框架模拟导航目标

对于无法修改参数类型的场景，可以使用MockK等框架模拟导航目标：

@Test
fun testNavigation() {
    mockkObject(MyScreenDestination)
    every {
        MyScreenDestination.invoke(any(), any())
    } returns Direction("mocked_route")
    
    // 执行测试逻辑
}

方案三：使用Android单元测试

如果测试逻辑必须依赖Android框架：

1. 将测试迁移到androidTest目录
2. 使用AndroidJUnitRunner运行测试
3. 在真实或模拟的Android环境中执行测试

最佳实践建议

1. 分层测试：将纯逻辑测试与Android相关测试分离
2. 依赖注入：通过接口抽象导航逻辑，便于测试
3. 测试替身：为Android特定类型创建测试专用的替代实现
4. 构建配置：合理配置Gradle以区分单元测试和仪器化测试

总结

在Compose Destinations项目中处理包含Android特定类型参数的导航目标时，开发者需要特别注意测试环境的限制。通过选择合适的序列化方案或测试策略，可以有效解决这类跨平台兼容性问题，确保导航逻辑的可测试性。