Flutter应用启动时键盘若处于可见状态无法关闭的问题求助

你之前尝试的方案不生效的核心原因是调用时机错误：initState阶段Widget还未完成渲染树挂载，build阶段上下文尚未完全关联焦点树，此时操作焦点节点无法命中正确的聚焦对象。可按以下方案解决：

方案1：首帧渲染完成后执行收起逻辑 #

在首个页面的initState中添加帧结束回调，等待第一帧渲染完成后再执行焦点收起操作，同时叠加系统级隐藏键盘接口作为兜底：

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

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

  @override
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addPostFrameCallback((_) {
      // 焦点树层面移除焦点
      final currentFocus = FocusScope.of(context);
      if (!currentFocus.hasPrimaryFocus && currentFocus.focusedChild != null) {
        FocusManager.instance.primaryFocus?.unfocus();
      }
      // 系统层面强制隐藏键盘兜底
      SystemChannels.textInput.invokeMethod('TextInput.hide');
    });
  }

  @override
  Widget build(BuildContext context) {
    return const Scaffold(
      // 你的页面原有内容
    );
  }
}

方案2：全局路由监听统一处理 #

如果多页面存在类似问题，可以给MaterialApp注册路由观察者，每次页面打开时自动收起键盘：

1. 自定义路由观察者类

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

class AutoHideKeyboardObserver extends NavigatorObserver {
  @override
  void didPush(Route<dynamic> route, Route<dynamic>? previousRoute) {
    super.didPush(route, previousRoute);
    WidgetsBinding.instance.addPostFrameCallback((_) {
      FocusManager.instance.primaryFocus?.unfocus();
      SystemChannels.textInput.invokeMethod('TextInput.hide');
    });
  }
}

2. 注册到MaterialApp配置中

MaterialApp(
  navigatorObservers: [AutoHideKeyboardObserver()],
  // 其他原有配置：title、theme、home等
)

方案3：Android端原生层配置 #

如果是Android冷启动时上一次应用使用残留的键盘状态导致的问题，可以在Android项目的AndroidManifest.xml对应Activity节点添加属性，强制启动时隐藏键盘：

android:windowSoftInputMode="stateHidden"

补充说明 #

• 检查首个页面所有TextField组件，确认没有误设置autofocus: true，如果确实需要自动聚焦，可以延迟到首帧渲染完成后再主动请求焦点
• 极端场景下可以在收起逻辑前加50-100ms的延迟作为兜底：

Future.delayed(const Duration(milliseconds: 50), () {
  FocusManager.instance.primaryFocus?.unfocus();
  SystemChannels.textInput.invokeMethod('TextInput.hide');
});

内容的提问来源于stack exchange，提问作者ritik kumar srivastava