Compose主题行为不一致求助：多Activity背景显示异常

主题配置代码 #

// 深色模式使用浅色配色
private val ConceptualSystemsDarkColorScheme = darkColorScheme(
    primary = Yellowish,
    secondary = YellowishBright,
    tertiary = Orangeish,
    background = Color.Black,
    surface = Color.Black,
    onBackground = Color.Black,
)

// 浅色模式使用深色配色
private val ConceptualSystemsLightColorScheme = lightColorScheme(
    primary = DarkYellowish,
    secondary = DarkYellowishDim,
    tertiary = DarkOrangeish,
    background = Yellowish,
    surface = Yellowish,
    onBackground = Yellowish,
)

@Composable
fun ConceptualSystemsTheme(
    useDarkTheme: Boolean = false, // 强制不使用深色主题
    dynamicColor: Boolean = false,
    content: @Composable () -> Unit
) {
    val logger = LoggerFactory.getLogger("Theme")
    val colorScheme = when {
        dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> {
            logger.info("THEME: found build version : "
                    + Build.VERSION.SDK_INT + " >= " + Build.VERSION_CODES.S
                    + " : opting for dynamic system color scheme...")
            val context = LocalContext.current
            if(useDarkTheme) {
                logger.info("Using dark dynamic color scheme")
                dynamicDarkColorScheme(context)
            } else {
                logger.info("Using light dynamic color scheme")
                dynamicLightColorScheme(context)
            }
        }
        useDarkTheme -> {
            logger.info("Using dark color scheme")
            ConceptualSystemsDarkColorScheme
        }
        else -> {
            logger.info("Using light color scheme")
            ConceptualSystemsLightColorScheme
        }
    }

    MaterialTheme(
        shapes = MaterialTheme.shapes.copy(
            RoundedCornerShape(6.dp)
        ),
        colorScheme = colorScheme,
        typography = DefaultTypography,
        content = content
    )
}

主题调用方式 #

setContent {
    ConceptualSystemsTheme {
        MainLayout(keepDriverNumber.collectAsState(initial = false))
    }
}

问题现象 #

• 不同Activity背景表现不一致：一个显示预期的黄色，一个显示黑色，还有一个上半部分黄色、LazyColumn下方区域黑色
• Logcat确认每次都加载浅色主题，测试设备为Android 9，动态主题已排除

异常效果截图：

• 预期正常效果：
  
• 异常：Activity背景全黑
  
• 异常：LazyColumn下方区域变黑
  

排查与解决建议 #

1. 确保根布局继承主题背景色
   Compose不会自动给根布局填充主题背景色，需要手动用Surface包裹根内容，或者给根布局的Modifier设置背景：

setContent {
    ConceptualSystemsTheme {
        Surface(
            modifier = Modifier.fillMaxSize(),
            color = MaterialTheme.colorScheme.background
        ) {
            MainLayout(keepDriverNumber.collectAsState(initial = false))
        }
    }
}

2. 修复LazyColumn背景缺失问题
   LazyColumn本身不会自动填充背景，需给它添加背景配置：

LazyColumn(
    modifier = Modifier
        .fillMaxSize()
        .background(MaterialTheme.colorScheme.background)
) {
    // 列表项内容
}

3. 检查Manifest中的Activity主题冲突
   确保所有使用Compose的Activity，其AndroidManifest中的android:theme指向基础的Material3无ActionBar主题（如Theme.Material3.Light.NoActionBar），避免传统XML主题覆盖Compose的背景设置。

4. 排查硬编码背景色
   检查是否有Composable组件手动设置了Color.Black背景，导致局部区域显示异常。

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