Flutter自定义ThemeData未生效、被默认主题覆盖问题求助

排查与解决步骤 #

• 修正路由配置错误
  你当前配置的initialRoute: 'sign_in'不在路由表范围内，路由表仅定义了/、/home两个路由，路由加载异常会导致全局配置不生效。将initialRoute改为路由表中存在的值，或者补充sign_in对应的路由配置即可。
• 适配Material3主题规则
  Flutter 3.0+版本默认开启Material3设计规范，此时ThemeData中单独设置的primaryColor、primaryColorLight等属性优先级低于colorScheme下的对应配色，你当前仅配置了colorScheme的secondary属性，其余配色均为系统默认值，自然看不到自定义主题效果。
  两种修复方案二选一：
  1. 关闭Material3开关，在ThemeData.copyWith中新增useMaterial3: false，沿用旧版Material2的主题规则
  2. 完整配置colorScheme所有属性，示例如下：

  colorScheme: ColorScheme.fromSwatch(
    brightness: Brightness.light,
  ).copyWith(
    primary: PrimaryColor,
    primaryLight: PrimaryColorLight,
    primaryDark: PrimaryColorDark,
    secondary: SecondaryColor,
    // 按需补充onPrimary、background等其余配色
  )
  

• 检查页面主题引用方式
  确认页面内使用颜色时是通过Theme.of(context)调用全局主题，而非硬编码颜色值，比如主色调用写法为Theme.of(context).colorScheme.primary，而非直接写固定颜色值。
• 清理编译缓存重试
  执行flutter clean清理本地编译缓存后重新运行项目，排除增量编译导致的配置未更新问题。
• 排查子组件强制覆盖配置
  检查Wrapper、MainApp等子页面内部是否嵌套了Theme组件，或是给AppBar、Scaffold等组件单独设置了backgroundColor等样式，单独给组件设置的样式优先级高于全局主题，会导致全局主题被覆盖。

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