Flutter 2 升级后状态栏图标、TextField上下文菜单颜色异常的排查与修复

Flutter 2 对Material主题的样式推导逻辑做了底层重构，打破了旧版本的固定继承规则，你遇到的两个异常都是这套新逻辑导致的：

• 状态栏图标变黑的原因：旧版本Flutter下，只要主题基于深色模式构建，系统会强制把状态栏图标渲染为白色，不会做额外判断。Flutter 2 开始，系统UI（状态栏、导航栏）的图标颜色不再识别你是否基于ThemeData.dark()构建主题，而是读取当前主题的brightness配置、背景色明暗值自动推导适配图标颜色。当你自定义了大量深色背景色之后，如果没有显式声明主题的亮度模式，组件会把这套自定义深灰色配置误判为浅色主题场景，自然就渲染出黑色的状态栏图标。
• TextField上下文菜单文字变黑的原因：旧版本下，输入框长按弹出的复制/粘贴/选择菜单的文字颜色，会直接跟随全局文字主题的默认色，和背景色没有联动。Flutter 2 重构了文本选择菜单的样式继承逻辑，现在这类菜单的背景色直接读取主题的cardColor值，文字颜色则由系统根据背景色自动计算对比度生成适配色。你把cardColor设为自定义深灰色时，系统的对比度计算出现偏差，没有匹配到深色背景对应的白色文字规则，就默认生成了黑色文字，和深灰色背景几乎不可见。

你之前尝试移除自定义cardColor后菜单恢复正常，本质是因为回到了默认深色主题的cardColor值（接近纯黑），系统重新计算对比度时匹配到了正确的白色文字规则，但这也会导致其他依赖cardColor的组件样式被全局重置。

不需要推翻现有自定义配色逻辑，只要补全关键的主题配置，就能同时解决两个异常：

• 第一步：补全主题核心亮度声明
  你现在构建的ThemeData是基于深色模式的自定义配置，直接在返回的ThemeData构造函数里显式加上亮度配置，避免系统误判主题模式：
  在return ThemeData(...)的属性列表开头加上 brightness: Brightness.dark,，强制声明整个主题为深色模式，从根源上避免系统把自定义深灰色配置误判为浅色主题。
• 第二步：稳定修复状态栏图标颜色
  不依赖系统的自动推导逻辑，直接在MaterialApp层全局声明固定的状态栏样式，这是最稳定的方案，不会受后续主题调整的影响：
  首先导入系统服务工具：import 'package:flutter/services.dart';
  然后在MaterialApp配置里通过全局builder包裹一层AnnotatedRegion，强制指定状态栏图标为亮色：

  MaterialApp(
    theme: buildTheme(),
    builder: (context, child) {
      return AnnotatedRegion<SystemUiOverlayStyle>(
        value: const SystemUiOverlayStyle(
          // 强制状态栏图标为白色，不受自动推导逻辑影响
          statusBarIconBrightness: Brightness.light,
          statusBarColor: Colors.transparent,
        ),
        child: child!,
      );
    },
  )
  

• 第三步：修复TextField上下文菜单的文字颜色
  不需要移除自定义的cardColor配置，只需要在ThemeData里新增文本选择主题的显式配置，固定菜单文字为白色即可：
  在buildTheme函数的返回配置里，新增textSelectionTheme字段：

  textSelectionTheme: TextSelectionThemeData(
    // 文本选择手柄、光标复用你定义的主题强调色
    cursorColor: colors.accent(),
    selectionHandleColor: colors.accent(),
  ),
  

  如果是Flutter 3.0以上版本，还可以搭配menuTheme字段显式指定长按菜单的文字颜色，彻底避免自动推导的色差问题：

  menuTheme: MenuThemeData(
    style: MenuStyle(
      backgroundColor: MaterialStatePropertyAll(colors.messageBackground()),
      textStyle: const MaterialStatePropertyAll(TextStyle(color: Colors.white)),
    ),
  )
  

  配置完成后，自定义的深灰色菜单背景会完全保留，同时菜单上的文字会固定为白色，不会再出现自动变黑的问题。

内容的提问来源于stack exchange，提问作者S-Man