Flutter自定义AppBar返回按钮异常：非可回退页面仍显示

问题根源 #

你遇到的问题本质是：persistent_bottom_nav_bar 的每个底部Tab都维护着独立的导航栈，而你当前用全局的 Navigator.canPop(context) 和 Get.key.currentState!.canPop() 判断时，会把其他Tab的栈状态或者历史路由栈状态算进来，导致底部导航的根页面（比如Screen A）错误地显示返回按钮。

具体修复步骤 #

1. 关闭默认返回按钮的自动生成

首先把 AppBar 的 automaticallyImplyLeading 设为 false，避免默认按钮和自定义按钮冲突，确保完全由你的逻辑控制显示：

AppBar(
  backgroundColor: Colors.transparent,
  automaticallyImplyLeading: false, // 此处改为false
  toolbarHeight: 70.0,
  elevation: 0.0,
  // 后续代码...
)

2. 针对当前Tab的导航栈做判断

利用 persistent_bottom_nav_bar 提供的 PersistentTabController，获取当前Tab对应的导航栈，只判断该栈是否可回退，同时结合GetX的全局路由栈处理用Get推送的页面：

首先确保你已通过GetX注入了控制器：

// 项目初始化时完成注入
Get.put(PersistentTabController(initialIndex: 0));

然后在Screen A页面中修改判断逻辑：

final _tabController = Get.find<PersistentTabController>();

// ...

AppBar(
  // 其他属性...
  leading: () {
    // 获取当前Tab对应的导航栈状态
    final currentTabNav = _tabController.navigatorKeys[_tabController.index]?.currentState;
    bool canPop = false;

    // 优先判断当前Tab的本地栈是否可回退
    if (currentTabNav?.canPop() == true) {
      canPop = true;
    } 
    // 再判断Get全局路由栈（处理用Get.to()推送的页面）
    else if (Get.key.currentState?.canPop() == true) {
      // 过滤底部Tab根页面的误判：如果当前路由是底部Tab页面，不显示返回按钮
      final isBottomTabRoute = ['/screenA', '/screenB'].contains(Get.currentRoute);
      canPop = !isBottomTabRoute;
    }

    return canPop ? ClipOval(
      child: Material(
        color: Theme.of(context).primaryColor,
        child: InkWell(
          onTap: () {
            // 优先处理当前Tab的本地栈回退
            if (currentTabNav?.canPop() == true) {
              currentTabNav?.pop();
            } 
            // 再处理Get全局栈回退
            else if (Get.key.currentState?.canPop() == true) {
              Get.back();
            }
          },
          child: const SizedBox(
            width: 40,
            height: 40,
            child: Icon(
              Icons.arrow_back_ios_new_outlined,
              color: Colors.white,
              size: 25.0,
            ),
          ),
        ),
      ),
    ) : const SizedBox();
  }(),
)

3. 额外优化：给底部Tab页面加路由标记

注册底部Tab页面路由时，添加特定标签，方便后续快速判断：

GetPage(
  name: '/screenA',
  page: () => ScreenA(),
  tag: 'bottom_tab',
),

之后判断Get栈时可以简化逻辑：

final currentRoute = Get.routing.current;
final isBottomTabRoot = currentRoute?.settings.tag == 'bottom_tab' && !Get.key.currentState!.canPop();
// 若是底部Tab根页面，直接隐藏返回按钮

为什么之前的逻辑会出错 #

当你从Screen B推送Screen A实例后返回，Screen B所在的Tab栈会留存push/pop记录，但全局的Get栈或Navigator栈可能残留可pop状态标记。切换回Screen A的Tab时，全局canPop判断会返回true，但Screen A是当前Tab的根页面，本不应显示返回按钮。而用当前Tab的导航栈判断就能避免这个问题。

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