Jetpack Compose预览报错：Failed to instantiate Composition Local（关联FirebaseAuth）

当你在Compose组件或预览函数中直接获取FirebaseAuth实例时，预览会抛出Failed to instantiate Composition Local错误——哪怕你根本没使用这个实例。问题出在预览环境是独立沙箱，无法正确初始化Firebase依赖的底层服务（比如Google Play服务相关组件）。

下面是几种可行的解决方式：

1. 预览环境使用模拟实例+参数传递 #

把FirebaseAuth作为参数传入Compose组件，预览时提供一个模拟的空实现，避免触发真实Firebase初始化：

@Composable
fun App(auth: FirebaseAuth) {
    // 你的UI代码
}

@Preview(showBackground = true)
@Composable
fun DefaultPreview() {
    // 创建一个模拟的FirebaseAuth实例，仅用于预览
    val mockAuth = object : FirebaseAuth() {
        // 重写UI中用到的核心方法，比如返回模拟用户
        override fun getCurrentUser(): FirebaseUser? {
            return object : FirebaseUser() {
                override fun getUid(): String = "preview-user-123"
                // 其他必要方法可以返回默认值或空实现
            }
        }
    }

    HabitsTheme {
        App(auth = mockAuth)
    }
}

// 生产环境调用时传入真实实例
@Composable
fun ProductionApp() {
    HabitsTheme {
        App(auth = Firebase.auth)
    }
}

2. 用LocalInspectionMode判断预览环境 #

通过LocalInspectionMode.current检测是否处于预览状态，仅在非预览环境初始化真实的FirebaseAuth：

@Composable
fun App() {
    val isPreview = LocalInspectionMode.current
    val auth = if (!isPreview) {
        Firebase.auth
    } else {
        // 预览时返回模拟实例
        object : FirebaseAuth() {
            override fun getCurrentUser(): FirebaseUser? {
                return object : FirebaseUser() {
                    override fun getUid(): String = "preview-user-id"
                }
            }
        }
    }

    // 你的UI代码
}

@Preview(showBackground = true)
@Composable
fun DefaultPreview() {
    HabitsTheme {
        App()
    }
}

3. 结合依赖注入框架（如Hilt） #

如果使用Hilt做依赖注入，可以为预览环境单独提供模拟的FirebaseAuth绑定：

// 生产环境的Firebase模块
@Module
@InstallIn(SingletonComponent::class)
object FirebaseProductionModule {
    @Provides
    fun provideFirebaseAuth(): FirebaseAuth = Firebase.auth
}

// 预览环境的模拟模块
@Module
@InstallIn(SingletonComponent::class)
@UninstallModules(FirebaseProductionModule::class)
object FirebasePreviewModule {
    @Provides
    fun provideMockFirebaseAuth(): FirebaseAuth = object : FirebaseAuth() {
        override fun getCurrentUser(): FirebaseUser? {
            return object : FirebaseUser() {
                override fun getUid(): String = "preview-user"
            }
        }
    }
}

// 组件中通过Hilt注入
@HiltComposable
fun App() {
    val auth = hilt<FirebaseAuth>()
    // 你的UI代码
}

// 预览函数
@Preview(showBackground = true)
@Composable
@HiltComposable
fun DefaultPreview() {
    HabitsTheme {
        App()
    }
}

核心思路就是：不让预览环境触发真实FirebaseAuth的初始化，用模拟实例替代即可绕过这个错误。

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