Flutter RawKeyboardListener在iOS端软键盘按键时onKey未触发

在iOS平台使用RawKeyboardListener组件时，查阅相关问题记录后认为该功能已支持iOS端，但实际测试中按下iOS软键盘任意按键都不会触发onKey回调，对应实现代码如下：

import 'package:flutter/material.dart';

const Color darkBlue = Color.fromARGB(255, 18, 32, 47);

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: ThemeData.dark().copyWith(
        scaffoldBackgroundColor: darkBlue,
      ),
      debugShowCheckedModeBanner: false,
      home: Scaffold(
        body: Center(
          child: MyWidget(),
        ),
      ),
    );
  }
}

class MyWidget extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return RawKeyboardListener(
      focusNode: FocusNode(),
      onKey: (event) {
        print('Keyboard event detected');
      },
      child: const TextField(),
    );
  }
}

• RawKeyboardListener的设计定位就是仅监听物理外接键盘的原始按键事件，你查到的问题修复针对的是iOS外接物理键盘的事件上报问题，和系统软键盘无关。iOS、Android端的软键盘输入走的是框架独立的文本输入通道，不会触发RawKeyboardListener的回调，这不是配置缺失，是组件本身的功能边界。
• 现有代码的FocusNode是在build方法内临时创建的实例，没有做焦点请求操作，哪怕是连接物理键盘，当前焦点节点未获取焦点的情况下也不会触发事件回调。

根据你的实际监听需求选对应实现即可：

• 如果只是需要获取输入内容变化
  不要用RawKeyboardListener，给TextField绑定TextEditingController，通过控制器监听输入变化：

  // 省略无关代码
  class _MyWidgetState extends State<MyWidget> {
    final TextEditingController _editController = TextEditingController();
  
    @override
    void initState() {
      super.initState();
      _editController.addListener(() {
        // 这里可以拿到最新输入内容
        debugPrint('当前输入：${_editController.text}');
      });
    }
  
    @override
    void dispose() {
      _editController.dispose();
      super.dispose();
    }
  
    @override
    Widget build(BuildContext context) {
      return TextField(controller: _editController);
    }
  }
  

• 如果需要监听软键盘的特殊按键（删除、回车等）、细粒度输入事件
  使用Flutter 3.10及以上版本提供的KeyboardListener组件，该组件同时支持物理键盘和系统软键盘的事件上报；也可以通过TextField的onEditingComplete、inputFormatters做特定场景的输入拦截。
• 如果确实只需要监听外接物理键盘事件
  修正现有代码的FocusNode用法即可：

  class MyWidget extends StatefulWidget {
    const MyWidget({super.key});
  
    @override
    State<MyWidget> createState() => _MyWidgetState();
  }
  
  class _MyWidgetState extends State<MyWidget> {
    // 将FocusNode作为状态变量持有，不要在build方法内临时创建
    final FocusNode _rawKeyFocusNode = FocusNode();
  
    @override
    void dispose() {
      _rawKeyFocusNode.dispose();
      super.dispose();
    }
  
    @override
    Widget build(BuildContext context) {
      return RawKeyboardListener(
        focusNode: _rawKeyFocusNode,
        onKey: (event) {
          if (event is RawKeyDownEvent) {
            debugPrint('检测到物理键盘按键：${event.logicalKey.debugName}');
          }
        },
        child: TextField(
          onTap: () => _rawKeyFocusNode.requestFocus(),
        ),
      );
    }
  }
  

注意：所有版本的Flutter中，RawKeyboardListener都不会响应软键盘事件，不要在这个方向上浪费时间排查配置。

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