Jetpack Compose Preview调用ThreeTen的LocalDate.now()渲染失败如何解决

你遇到的报错ZoneRulesException: No time-zone data files registered是因为ThreeTen Android Backport库依赖提前初始化加载时区数据：

• 正常App运行时，你会在Application启动时调用AndroidThreeTen.init(context)完成初始化
• Jetpack Compose Preview运行在Android Studio的沙盒环境，没有执行App的初始化流程，也无法拿到完整的Application上下文，导致ThreeTen的时区规则没有注册，调用LocalDate.now()时触发报错。

下面三个方案可以根据你的项目情况选择：

• 方案1：预览环境手动初始化（无侵入，改少量代码）
  在预览Composable的最开头插入初始化逻辑，仅在预览模式下执行，避免影响正式代码：

import androidx.compose.ui.tooling.preview.LocalInspectionMode
import org.threeten.bp.ZoneId
import org.threeten.bp.zone.ZoneRulesProvider

@Composable
fun initThreeTenPreview() {
    if (LocalInspectionMode.current && ZoneRulesProvider.getAvailableZoneIds().isEmpty()) {
        ZoneRulesProvider.registerProvider(object : ZoneRulesProvider() {
            override fun provideZoneIds(): Set<String> = setOf("UTC", "Asia/Shanghai")
            override fun provideRules(zoneId: String, forCaching: Boolean) = ZoneId.of("UTC").rules
        })
    }
}

在你的预览函数第一行调用即可：

@Preview
@Composable
fun DefaultPickupsListPreview() {
    initThreeTenPreview()
    AppTheme {
        PickupsList()
    }
}

• 方案2：依赖注入解耦硬编码时间调用（更规范，长期收益高）
  不要在业务代码中直接调用LocalDate.now()，通过CompositionLocal提供全局时间提供者，预览时直接注入固定测试时间，从根源规避初始化问题：

// 定义全局时间提供者CompositionLocal
val LocalTimeProvider = staticCompositionLocalOf {
    object {
        fun currentLocalDate() = LocalDate.now()
        fun currentLocalDateTime() = LocalDateTime.now()
    }
}

// 预览时替换为固定时间
@Preview
@Composable
fun DefaultPickupsListPreview() {
    CompositionLocalProvider(
        LocalTimeProvider provides object {
            fun currentLocalDate() = LocalDate.of(2024, 6, 18)
            fun currentLocalDateTime() = LocalDateTime.of(2024, 6, 18, 10, 30)
        }
    ) {
        AppTheme {
            PickupsList()
        }
    }
}

// 业务代码中替换所有直接调用LocalDate.now()的地方
val now = LocalTimeProvider.current.currentLocalDate()

• 方案3：新增debug依赖（零代码修改）
  仅在debug变体引入Java虚拟机版本的ThreeTen时区数据依赖，预览环境会自动加载时区数据，无需修改业务代码。
  在模块级build.gradle中添加依赖：

dependencies {
    // 原有ThreeTen依赖保留
    implementation 'com.jakewharton.threetenabp:threetenabp:1.4.6'
    // 新增debug变体依赖，不会打包到release包
    debugImplementation 'org.threeten:threetenbp:1.6.8'
}

• 方案1的初始化逻辑一定要加LocalInspectionMode.current判断，避免正式运行时重复注册时区规则抛出异常
• 方案2虽然需要修改现有代码，但更符合依赖注入原则，也方便后续做单元测试和时间模拟

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