Flutter TextField在Android模拟器无法输入，iOS模拟器正常求助

我开发的Flutter应用里，TextField组件在Android模拟器中无法输入文本，但iOS模拟器运行正常。相同代码在其他应用里能正常工作，相关代码如下，求帮忙排查问题：

class GeneralRegistration extends StatelessWidget {
  final int lengthLimitingTextInputFormatter;
  final String phoneNumberHint;
  final String phoneNumberPrefix;
  const GeneralRegistration({
    super.key,
    required this.lengthLimitingTextInputFormatter,
    required this.phoneNumberHint,
    required this.phoneNumberPrefix,
    
  });

    @override
      Widget build(BuildContext context) {
        final screenHeight = MediaQuery.of(context).size.height;
        final screenWidth = MediaQuery.of(context).size.width;
        final phone = TextEditingController();
    
        return StatefulBuilder(builder: (context, StateSetter setState) {
          return Scaffold(
            backgroundColor: Colors.black,
            appBar: Utils().appBar(context),
            body: Container(
                         child: TextField(
                            inputFormatters: [
                              LengthLimitingTextInputFormatter(
                                  lengthLimitingTextInputFormatter)
                            ],
                            textInputAction: TextInputAction.done,
                            keyboardType: TextInputType.number,
                            onChanged: (value) {
                              if (value.length ==
                                  lengthLimitingTextInputFormatter) {
                                setState(() {});
                              }
                            },
                            controller: phone,
                            style: const TextStyle(
                                color: Colors.white,
                                fontSize: 40,
                                fontWeight: FontWeight.bold),
                            decoration: InputDecoration(
                                hintText: phoneNumberHint,
                                hintStyle: TextStyle(
                                    color: Colors.grey.shade600, fontSize: 20),
                                prefix: Text(
                                  phoneNumberPrefix,
                                  style: const TextStyle(
                                      fontSize: 40, color: Colors.white),
                                ),
                                suffixIcon: phone.text.length ==
                                        lengthLimitingTextInputFormatter
                                    ? const Icon(
                                        Icons.done,
                                        color: Colors.green,
                                        size: 40,
                                      )
                                    : null),
                          ),
                        ),
          );
        });
      }
    }

核心问题排查与修复方案 #

• TextEditingController生命周期错误
  你在build方法内初始化phone控制器，每次调用setState触发重构建时，控制器都会被重新创建，导致输入内容被清空。Android上这个问题表现更突出，因为系统输入法的状态同步逻辑和iOS存在差异。

• StatefulBuilder的不合理使用
  用StatelessWidget嵌套StatefulBuilder的方式，无法稳定保存控制器状态。直接改用StatefulWidget是更规范的做法。

• 参数命名冲突
  构造参数lengthLimitingTextInputFormatter和输入格式化器类名重复，容易引发混淆，建议重命名为maxLength。

修改后的代码示例 #

class GeneralRegistration extends StatefulWidget {
  final int maxLength;
  final String phoneNumberHint;
  final String phoneNumberPrefix;
  
  const GeneralRegistration({
    super.key,
    required this.maxLength,
    required this.phoneNumberHint,
    required this.phoneNumberPrefix,
  });

  @override
  State<GeneralRegistration> createState() => _GeneralRegistrationState();
}

class _GeneralRegistrationState extends State<GeneralRegistration> {
  late final TextEditingController phoneController;

  @override
  void initState() {
    super.initState();
    phoneController = TextEditingController();
  }

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

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      backgroundColor: Colors.black,
      appBar: Utils().appBar(context),
      body: Container(
        child: TextField(
          inputFormatters: [
            LengthLimitingTextInputFormatter(widget.maxLength)
          ],
          textInputAction: TextInputAction.done,
          keyboardType: TextInputType.number,
          onChanged: (value) {
            if (value.length == widget.maxLength) {
              setState(() {});
            }
          },
          controller: phoneController,
          style: const TextStyle(
              color: Colors.white,
              fontSize: 40,
              fontWeight: FontWeight.bold),
          decoration: InputDecoration(
              hintText: widget.phoneNumberHint,
              hintStyle: TextStyle(
                  color: Colors.grey.shade600, fontSize: 20),
              prefix: Text(
                widget.phoneNumberPrefix,
                style: const TextStyle(
                    fontSize: 40, color: Colors.white),
              ),
              suffixIcon: phoneController.text.length == widget.maxLength
                  ? const Icon(
                      Icons.done,
                      color: Colors.green,
                      size: 40,
                    )
                  : null),
        ),
      ),
    );
  }
}

额外检查项 #

• 确认Android模拟器使用的是系统默认输入法，部分第三方输入法可能和Flutter TextField存在兼容性问题。
• 检查Flutter SDK版本，尝试升级到稳定版，修复可能存在的平台适配BUG。

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