Flutter：Android键盘打开时按返回键如何同时关闭AlertDialog

针对你遇到的问题——弹窗内TextField自动聚焦弹出键盘后，Android返回键需按两次才能关闭弹窗，这里提供可靠的非延迟依赖方案，核心思路是监听键盘状态变化+结合PopScope处理返回逻辑，避免依赖动画时长的不稳定实现。

实现思路 #

1. 监听MediaQuery的viewInsets变化，精准判断键盘的显示/隐藏状态
2. 通过PopScope拦截返回键操作：第一次按下时先关闭键盘，键盘关闭后自动触发弹窗关闭
3. 用状态变量避免重复调用Navigator.pop导致的黑屏问题

完整代码示例 #

import 'package:flutter/material.dart';

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

  @override
  State<BasicWindow> createState() => _BasicWindowState();
}

class _BasicWindowState extends State<BasicWindow> {
  bool _isKeyboardVisible = false;
  bool _isDialogClosing = false;

  @override
  void initState() {
    super.initState();
    // 持续监听键盘状态变化
    WidgetsBinding.instance.addPersistentFrameCallback((_) {
      final currentKeyboardState = MediaQuery.of(context).viewInsets.bottom > 0;
      if (_isKeyboardVisible != currentKeyboardState) {
        setState(() {
          _isKeyboardVisible = currentKeyboardState;
        });
        // 键盘从显示转为隐藏时，自动关闭弹窗
        if (!currentKeyboardState && mounted && !_isDialogClosing) {
          _isDialogClosing = true;
          Navigator.pop(context);
        }
      }
    });
  }

  @override
  Widget build(BuildContext context) {
    return PopScope(
      onPopInvoked: (didPop) {
        if (didPop) return;
        // 返回键按下时，若键盘显示则先关闭键盘，否则直接关闭弹窗
        if (_isKeyboardVisible) {
          FocusManager.instance.primaryFocus?.unfocus();
        } else {
          _isDialogClosing = true;
          Navigator.pop(context);
        }
      },
      child: AlertDialog(
        content: TextField(
          autofocus: true,
          onSubmitted: (value) {
            _isDialogClosing = true;
            Navigator.pop(context);
          },
        ),
      ),
    );
  }
}

方案优势 #

• 无延迟依赖：通过系统API监听键盘状态，完全不依赖动画时长，适配不同设备的键盘动画速度
• 逻辑闭环：返回键操作、键盘关闭、弹窗关闭三者联动，符合用户预期的一键关闭体验
• 避免重复操作：_isDialogClosing状态变量确保Navigator.pop只执行一次，防止黑屏问题

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