Android Immersive(-sticky)模式结合Popup Menu时导航栏无法完全隐藏——是API Bug还是代码问题？

这个情况其实是Android系统处理系统级弹窗与沉浸式模式交互时的已知设计行为，算不上严格意义上的API Bug，但确实是个很容易踩坑的细节。

为什么会出现这个问题？ #

系统自带的PopupMenu属于系统级弹窗组件，当它弹出时，系统会默认判定用户可能需要操作导航栏（比如返回、Home键），所以会临时恢复导航栏的显示——哪怕你用了IMMERSIVE_STICKY模式。在API 30及更早版本中，这种触发逻辑没有做特殊优化，就会出现透明导航栏"僵尸"重现的情况。

你的代码有没有问题？ #

你配置沉浸式模式的代码本身是没问题的，但默认用toolbar.inflateMenu()让系统自动处理菜单弹出的方式，会触发系统的默认UI调整逻辑，这才是导致问题的直接原因。

修复方案 #

我们可以通过手动控制PopupMenu的显示和关闭时机，在弹窗关闭后重新隐藏系统UI，就能解决这个问题：

1. 替换默认菜单处理逻辑
   修改你onCreate方法中的代码，手动给Toolbar的菜单设置点击监听，控制PopupMenu的显示，并在弹窗关闭后重新调用hideSystemUI()：

   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       setContentView(R.layout.activity_main);
       Toolbar toolbar = findViewById(R.id.toolbar);
       // 替换默认的inflateMenu方式，手动填充菜单
       toolbar.getMenuInflater().inflate(R.menu.main, toolbar.getMenu());
       
       toolbar.setOnMenuItemClickListener(item -> {
           // 匹配你的菜单项ID，替换成实际ID
           if (item.getItemId() == R.id.your_menu_item_id) {
               PopupMenu popupMenu = new PopupMenu(MainActivity.this, toolbar);
               popupMenu.inflate(R.menu.main);
               // 弹窗关闭时重新隐藏系统UI
               popupMenu.setOnDismissListener(menu -> hideSystemUI());
               popupMenu.show();
               return true;
           }
           return false;
       });
   }
   

2. 额外优化（针对API 30及以下）
   如果上面的方法还不够彻底，可以在PopupMenu显示前，给它的窗口添加全屏Flag，避免触发系统UI变化：

   popupMenu.setOnShowListener(menu -> {
       if (Build.VERSION.SDK_INT <= Build.VERSION_CODES.R) {
           Window popupWindow = popupMenu.getMenuInflater().getContext().getWindow();
           popupWindow.addFlags(WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS);
           popupWindow.addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN);
       }
   });
   

3. 终极方案：自定义PopupWindow
   如果系统的PopupMenu始终无法满足需求，可以考虑用PopupWindow自定义弹窗组件，完全控制弹窗的样式和行为，从根源上避免触发系统的UI调整逻辑。

总结 #

这个现象不是你的代码错误，是系统对系统级弹窗的默认交互逻辑导致的。通过手动控制PopupMenu的生命周期，并在关闭后恢复沉浸式状态，就能解决导航栏重现的问题。

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