Flutter应用加载时软键盘不自动弹出，需手动触发后才可唤起

问题根源分析 #

• 变量初始化错误：代码initState中错误地给未定义的focusNode赋值，而非类成员_focusNode，导致后续焦点请求因节点未初始化而失效。
• 焦点请求冲突：同时启用TextField的autofocus: true和通过SchedulerBinding+Timer手动请求焦点，两种逻辑在三星A33这类安卓设备上互相干扰，导致系统无法正确唤起软键盘。

修复后的代码 #

import 'dart:async';
import 'package:flutter/material.dart';
import 'package:flutter/scheduler.dart';

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

  @override
  // ignore: library_private_types_in_public_api
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<BestHome> {
  late FocusNode _focusNode;

  void _showKeyboard() {
    if (!_focusNode.hasFocus) {
      FocusScope.of(context).requestFocus(_focusNode);
    }
  }

  @override
  void initState() {
    super.initState();
    // 修正：初始化正确的焦点节点变量
    _focusNode = FocusNode();
    // UI绘制完成后统一请求焦点，避免冲突
    SchedulerBinding.instance.addPostFrameCallback((_) {
      _focusNode.requestFocus();
    });
  }

  @override
  void dispose() {
    _focusNode.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            TextField(
              // 移除autofocus，避免和手动请求逻辑冲突
              focusNode: _focusNode,
              decoration: const InputDecoration(
                hintText: 'Start typing...',
              ),
            ),
            const SizedBox(height: 20),
            ElevatedButton(
              onPressed: _showKeyboard,
              child: const Text('Show Keyboard'),
            ),
          ],
        ),
      ),
    );
  }
}

关键修改说明 #

1. 修正initState中的焦点节点初始化错误，确保_focusNode被正确实例化。
2. 移除TextField的autofocus配置，统一通过SchedulerBinding.addPostFrameCallback在UI绘制完成后请求焦点，消除逻辑冲突。
3. 在_showKeyboard方法中增加焦点状态判断，避免重复请求导致的无效操作。

额外设备适配提示 #

检查三星A33的系统设置：进入「语言和输入」，确认默认键盘的「自动弹出键盘」选项已开启，部分系统默认配置会限制键盘自动唤起。

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