Flutter Autofill结合Android生物识别验证无法正常填充问题求助

问题核心原因 #

你遇到的问题主要由两个常见的配置错误导致：

• onChanged中手动给controller赋值的操作，干扰了系统自动填充的流程
• 输入字段未包裹在AutofillGroup组件内，导致生物识别后的填充信号无法正确传递到字段

具体解决方案 #

1. 移除冗余的onChanged赋值

你的代码里onChanged回调中手动设置_email.text = value完全多余，TextFormField的controller会自动同步输入内容。这个手动赋值会打断系统自动填充时对controller的操作，直接导致验证后字段不更新。

修改后的字段代码：

TextFormField(
  controller: _email,
  enableSuggestions: true,
  autocorrect: false,
  autofillHints: const [AutofillHints.email],
  focusNode: _emailFocusNode,
  keyboardType: TextInputType.emailAddress,
  validator: (value) {
    if (value == null || value.isEmpty) {
      return context.tr(pleaseEnterYourEmailText);
    } else if (!value.isValidEmail()) {
      return context.tr(pleaseEnterCorrectEmailText);
    }
    return null;
  },
  // 移除这个冗余的onChanged回调
),

2. 用AutofillGroup包裹输入字段

Flutter的系统级自动填充（尤其是带生物识别验证的场景）必须依赖AutofillGroup来管理字段组，没有这个组件，系统无法正确完成填充的收尾流程。

示例结构：

AutofillGroup(
  child: Column(
    children: [
      TextFormField(
        controller: _email,
        enableSuggestions: true,
        autocorrect: false,
        autofillHints: const [AutofillHints.email],
        focusNode: _emailFocusNode,
        keyboardType: TextInputType.emailAddress,
        validator: (value) {
          if (value == null || value.isEmpty) {
            return context.tr(pleaseEnterYourEmailText);
          } else if (!value.isValidEmail()) {
            return context.tr(pleaseEnterCorrectEmailText);
          }
          return null;
        },
      ),
      // 如果有密码字段，也需要放在同一个AutofillGroup内
      TextFormField(
        autofillHints: const [AutofillHints.password],
        obscureText: true,
        // ...其他密码字段配置
      ),
    ],
  ),
),

3. 排查focusNode的自定义逻辑

如果你的_emailFocusNode有自定义的焦点监听（比如自动失焦、强制跳转等），也可能干扰自动填充的焦点流转。可以暂时移除focusNode的自定义逻辑，测试是否恢复正常，再逐步排查冲突点。

验证步骤 #

完成以上修改后，重新测试：点击邮箱字段选择保存的账号，完成生物识别验证后，字段应该能正常填充内容。

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