Flutter中FocusManager/FocusScope导致加载状态失效问题求助

问题核心 #

调用FocusManager.instance.primaryFocus?.unfocus()（或FocusScope.of(context).unfocus()）会触发Flutter框架的同步UI重建，若将这个操作放在await前的状态更新（如controller.startLoading(true)）之前/同时执行，会干扰Obx的状态订阅流程——虽然controller的isLoading值已经正确修改，但Obx无法触发UI更新，导致按钮状态不变化。

解决方法 #

1. 用微任务延迟执行键盘收起 #

让状态更新先完成通知Obx，再执行键盘收起：

void resetPassword() async {
  // 延迟执行unfocus，避免干扰状态更新
  Future.microtask(() {
    FocusManager.instance.primaryFocus?.unfocus();
  });

  try {
    controller.changeErrorStatus(false);

    if (emailController.text.isEmpty) {
      controller.changeErrorStatus(true);
      controller.changeErrorMessage("An Error Occurred, Email Field cannot be left blank.");
      controller.startLoading(false);
      return;
    }
    controller.startLoading(true);
    await Future.delayed(Duration(seconds: 5));

    // await FirebaseAuth.instance
    //     .sendPasswordResetEmail(email: emailController.text.trim())
    //     .timeout(const Duration(seconds: 5));

    controller.startLoading(false);
  } catch (e) {
    controller.changeErrorStatus(true);
    controller.startLoading(false);
    controller.changeErrorMessage("An Error Occurred, $e");
  }
}

2. 用帧回调在当前帧结束后执行收起 #

利用Flutter的帧回调机制，确保当前UI绘制完成后再处理键盘收起：

void resetPassword() async {
  WidgetsBinding.instance.addPostFrameCallback((_) {
    FocusManager.instance.primaryFocus?.unfocus();
  });

  try {
    // 原有业务逻辑不变
    controller.changeErrorStatus(false);

    if (emailController.text.isEmpty) {
      controller.changeErrorStatus(true);
      controller.changeErrorMessage("An Error Occurred, Email Field cannot be left blank.");
      controller.startLoading(false);
      return;
    }
    controller.startLoading(true);
    await Future.delayed(Duration(seconds: 5));

    controller.startLoading(false);
  } catch (e) {
    controller.changeErrorStatus(true);
    controller.startLoading(false);
    controller.changeErrorMessage("An Error Occurred, $e");
  }
}

3. 调整onTap中的执行顺序 #

如果是在按钮onTap中先调用unfocus再执行resetPassword，改成先执行resetPassword，再延迟收起键盘：

onTap: () {
  resetPassword();
  Future.microtask(() {
    FocusManager.instance.primaryFocus?.unfocus();
  });
}

原理说明 #

unfocus()是同步操作，会立即触发Focus相关组件的重建，这个重建流程会和Obx的状态通知流程冲突。当状态更新和unfocus同步执行时，Obx的状态订阅会被框架重建打断，无法及时响应isLoading的变化。通过延迟unfocus到微任务或下一帧，能确保状态更新的通知先被Obx处理完成，再执行键盘收起，避免两者的流程冲突。

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