Jetpack Compose预览显示错误字符串资源的原因及修复方案

问题现象 #

在Jetpack Compose预览中，使用stringResource()加载字符串资源时会随机显示错误内容（如其他资源的文本），但直接使用字面量字符串、运行应用或执行测试时显示正常。问题表现不稳定，涉及Android Studio Electric Eel及更早版本，Compose UI 1.2.1、1.3.3均受影响。

可能原因 #

• Android Studio预览缓存异常：Compose预览的资源解析缓存出现错乱，导致资源ID映射错误，加载了无关的字符串资源。
• 资源编译同步不及时：修改字符串资源后，IDE未正确同步编译后的资源文件，预览使用了旧的或错误的资源索引。
• Compose预览机制的资源解析Bug：部分Compose版本的预览系统在处理资源ID时存在偶发的索引错位问题，在资源较多或多模块项目中更易出现。

修复方法 #

• 清理并重新构建项目
  执行Build > Clean Project，再执行Build > Rebuild Project，强制重新编译所有资源文件，修复可能的资源索引错误。
• 清除Android Studio缓存
  进入File > Invalidate Caches...，勾选Clear file system cache and local history，点击Invalidate and Restart，彻底清理IDE缓存文件。
• 强制刷新预览
  在预览面板点击右上角的刷新按钮（↻），或右键预览面板选择Refresh Preview，避免预览使用旧缓存数据。
• 临时使用预览专用字符串（可选）
  开发阶段可为预览函数单独传入字面量字符串，避免预览异常影响效率，示例代码：

  @Composable
  fun TopicFailureContent(message: String = stringResource(R.string.load_topic_failure_message)) {
      Text(message)
  }
  
  @Preview(showBackground = true)
  @Composable
  fun TopicFailureContentPreview() {
      TopicFailureContent(message = "Something went wrong loading the topic")
  }
  

• 升级Android Studio和Compose版本
  尝试升级到Android Studio最新稳定版（如Flamingo及以上），同时升级Compose UI到对应兼容的最新版本，这类资源解析Bug通常会在后续版本中修复。
• 检查多模块资源冲突（多模块项目适用）
  确保不同模块的字符串资源无重复的name属性，避免资源ID冲突导致预览解析错误。

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