You need to enable JavaScript to run this app. Flutter应用在Android模拟器及实体机上不显示手机状态栏如何解决
优惠活动
大模型
产品
解决方案
定价
更多

Flutter应用在Android模拟器及实体机上不显示手机状态栏如何解决

Flutter Android端状态栏无法显示的排查与解决方案

1 Flutter层配置排查

  • 搜索项目中是否调用了SystemChrome.setEnabledSystemUIMode方法,如果传入参数为SystemUiMode.immersive、SystemUiMode.immersiveSticky、SystemUiMode.leanback,都会主动隐藏状态栏,修改为SystemUiMode.edgeToEdge或删除相关代码即可恢复显示。
  • 检查页面AppBar的systemOverlayStyle配置,如果statusBarColor设置为透明,且statusBarIconBrightness和页面背景色接近,会出现状态栏内容和背景融合的视觉效果,调整为和背景对比度足够的亮度值即可。
  • 检查Scaffold组件的extendBodyBehindAppBar属性是否为true且未配置AppBar,此时页面内容会顶到屏幕顶部覆盖状态栏,要么关闭该属性,要么给页面顶部添加对应状态栏高度的边距。
  • 排查是否引入了全屏类第三方插件,部分插件默认会隐藏状态栏,可查看插件配置项手动开启状态栏显示。

2 Android原生层配置排查

  • 打开android/app/src/main/res/values/styles.xml文件,检查App主题中是否存在<item name="android:windowFullscreen">true</item>配置,将值改为false或直接删除该配置项。
  • 检查AndroidManifest.xml中Activity节点的android:theme属性是否引用了全屏主题,替换为普通的AppCompat或MaterialComponents主题即可。
  • 排查是否存在原生层自定义代码调用了getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN, WindowManager.LayoutParams.FLAG_FULLSCREEN),删除该代码段即可。

3 修复验证步骤

修改完成后先执行flutter clean清理项目缓存,再重新编译运行应用,分别在模拟器和实体机的浅色/深色模式下测试,确认状态栏显示正常。

4 沉浸式状态栏适配方案

如果需要实现沉浸式状态栏效果,不要直接隐藏状态栏,可参考以下配置:

// 全局设置状态栏样式
SystemChrome.setSystemUIOverlayStyle(
  const SystemUiOverlayStyle(
    statusBarColor: Colors.transparent,
    // 浅色背景用Brightness.dark,深色背景用Brightness.light
    statusBarIconBrightness: Brightness.dark,
    statusBarBrightness: Brightness.light,
  ),
);

页面内容使用SafeArea组件包裹,避免内容被状态栏遮挡。

内容的提问来源于stack exchange,提问作者Mike Zero

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.15 03:24:04