如何修复Presenter层的Do not use BuildContexts across async gaps lint错误

这个错误的核心原因是：异步操作（比如await authenticate、await getUserType）执行期间，原Widget可能已经从Widget树中被移除（比如用户主动返回、页面被提前替换），此时你手里的context已经失效，继续用它调用导航、弹窗相关方法会触发异常，lint提示就是在提前预警这种风险。

下面是两种最靠谱的修复方式：

方案1：将Stateless转为Stateful，用mounted检查Widget状态 #

这种方式更符合Flutter的设计规范，把UI相关的导航/弹窗逻辑放回Widget的State中，Presenter只专注业务逻辑，彻底分离职责。

修改后的Widget代码： #

class LoginPage extends StatefulWidget {
  const LoginPage({super.key});

  @override
  State<LoginPage> createState() => _LoginPageState();
}

class _LoginPageState extends State<LoginPage> {
  final Presenter presenter = Presenter();
  String username = '';
  String password = '';

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: CustomButton.build(
        label: 'login',
        onPressed: _handleLogin,
      ),
    );
  }

  Future<void> _handleLogin() async {
    // 先弹出加载弹窗
    showDialog(
      context: context,
      barrierDismissible: false,
      builder: (ctx) => const Center(child: CircularProgressIndicator()),
    );

    try {
      // 调用Presenter的业务方法，不传递context
      final authResult = await presenter.authenticate(username, password);
      final userType = await presenter.getUserType(authResult);

      // 关键：检查当前Widget是否还挂载在树上
      if (!mounted) return;

      // 关闭弹窗并跳转页面
      Navigator.pop(context);
      if (userType == 1) {
        Navigator.pushReplacementNamed(context, 'a');
      } else if (userType == 2) {
        Navigator.pushReplacementNamed(context, 'b');
      }
    } catch (e) {
      // 异常处理也要检查mounted
      if (mounted) {
        Navigator.pop(context);
        // 这里可以加错误提示逻辑，比如showSnackBar
      }
    }
  }
}

修改后的Presenter代码： #

class Presenter {
  // 只负责业务逻辑，不处理UI相关操作
  Future<User> authenticate(String username, String password) async {
    // 原认证逻辑，返回用户信息
  }

  Future<int> getUserType(User user) async {
    // 原获取用户类型的异步逻辑
    return user.type;
  }
}

方案2：使用全局NavigatorKey管理导航（适合保持Stateless的场景） #

如果不想把Widget改成Stateful，可以用全局的NavigatorKey来获取导航上下文，避免直接传递Widget的context。

步骤1：定义全局NavigatorKey #

在项目的入口文件（比如main.dart）中定义全局key：

final GlobalKey<NavigatorState> appNavigatorKey = GlobalKey<NavigatorState>();

步骤2：绑定到MaterialApp #

void main() {
  runApp(
    MaterialApp(
      navigatorKey: appNavigatorKey,
      initialRoute: '/login',
      routes: {
        '/login': (ctx) => const LoginPage(),
        'a': (ctx) => const PageA(),
        'b': (ctx) => const PageB(),
      },
    ),
  );
}

步骤3：修改Widget和Presenter #

Widget代码（保持Stateless）：

class LoginPage extends StatelessWidget {
  const LoginPage({super.key});
  final Presenter presenter = Presenter();
  String username = '';
  String password = '';

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: CustomButton.build(
        label: 'login',
        onPressed: () => presenter.login(username, password),
      ),
    );
  }
}

Presenter代码：

class Presenter {
  Future<void> login(String username, String password) async {
    // 获取当前有效的导航上下文
    final currentContext = appNavigatorKey.currentContext;
    if (currentContext == null) return;

    showDialog(
      context: currentContext,
      barrierDismissible: false,
      builder: (ctx) => const Center(child: CircularProgressIndicator()),
    );

    try {
      final authResult = await authenticate(username, password);
      final userType = await getUserType(authResult);

      // 再次检查上下文是否有效
      final latestContext = appNavigatorKey.currentContext;
      if (latestContext == null) return;

      Navigator.pop(latestContext);
      if (userType == 1) {
        appNavigatorKey.currentState?.pushReplacementNamed('a');
      } else if (userType == 2) {
        appNavigatorKey.currentState?.pushReplacementNamed('b');
      }
    } catch (e) {
      final latestContext = appNavigatorKey.currentContext;
      if (latestContext != null) {
        Navigator.pop(latestContext);
        // 错误提示逻辑
      }
    }
  }

  Future<User> authenticate(String username, String password) async {
    // 原认证逻辑
  }

  Future<int> getUserType(User user) async {
    // 原类型获取逻辑
    return user.type;
  }
}

两种方案里，方案1更推荐，因为它严格遵循了Flutter的生命周期管理，职责划分更清晰；方案2适合快速改造现有Stateless Widget的场景，但全局key要注意不要滥用，避免耦合过重。

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