Flutter中如何捕获Android返回按钮的onBackPressed事件？

问题拆解与根源定位 #

你提到用WillPopScope时，只有Material顶部栏的返回箭头能触发onWillPop逻辑，但Android物理返回键没反应，还出现同时弹出当前页和下方页面的异常——后来你发现是上一个页面存在两个MaterialApp组件，这确实是Flutter路由管理里的典型坑！

每个MaterialApp都会独立创建一套Navigator路由栈和路由规则。当你在一个MaterialApp的页面里，跳转到另一个被MaterialApp包裹的页面时，物理返回键的事件会被上层的MaterialApp拦截处理，而不是当前页面的WillPopScope，这就导致了返回时同时弹出多个页面的异常行为。

解决方案：统一路由栈管理 #

1. 移除多余的MaterialApp #

Flutter应用只需要一个根MaterialApp作为整个应用的入口，所有页面都嵌套在这个根实例下，确保路由栈由同一个Navigator统一管理。

举个错误写法的例子（存在多个MaterialApp）：

// 上一个页面的错误代码
class PreviousPage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp( // 第一个MaterialApp
      home: Scaffold(
        body: ElevatedButton(
          onPressed: () {
            Navigator.push(context, MaterialPageRoute(
              builder: (_) => MaterialApp( // 第二个MaterialApp，问题根源！
                home: MyView(),
              )
            ));
          },
          child: Text("跳转至MyView"),
        ),
      ),
    );
  }
}

改成正确的写法（仅保留根MaterialApp）：

// 应用入口只保留一个MaterialApp
void main() => runApp(const MaterialApp(home: PreviousPage()));

class PreviousPage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            Navigator.push(context, MaterialPageRoute(
              builder: (_) => const MyView(), // 直接跳转，无需嵌套MaterialApp
            ));
          },
          child: const Text("跳转至MyView"),
        ),
      ),
    );
  }
}

2. 确认WillPopScope的正确用法 #

你的WillPopScope代码本身是有效的，当路由栈统一后，物理返回键的事件会正确传递到当前页面的WillPopScope：

class MyView extends StatelessWidget{ 
  const MyView({super.key});

  @override
  Widget build(BuildContext context) { 
    return WillPopScope(
      onWillPop: () async { 
        debugPrint("Will pop 触发！"); 
        return true; // 返回true允许页面弹出，返回false可阻止返回行为
      }, 
      child: ScopedModel<AppModel>(
        model: AppModel(), 
        child: Scaffold(
          // 你的页面内容
        )
      )
    );
  }
}

额外提示 #

如果是多模块场景确实需要独立路由栈，建议使用嵌套Navigator组件（而非重复创建MaterialApp），通过指定navigatorKey来管理独立栈，但这种场景在普通单应用里很少见，优先保证全局只有一个根MaterialApp即可。

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