TextField无法通过自动填充建议填充，手动选密码账户可正常填充

在登录表单中，系统会弹出账户自动填充建议，但选择后TextField未被填充；但从密码菜单选择同一账户却能正常填充，该问题在iPadOS 17.5.1和iOS 17.5.1上表现一致。

问题分析 #

你的代码中使用const修饰整个表单结构，导致TextField未绑定TextEditingController——iOS的自动填充系统需要通过控制器来更新输入框文本内容，这是自动填充失效的核心原因。同时const结构也限制了AutofillGroup与输入框的正常关联。

修复方案 #

为每个TextField添加TextEditingController，移除不必要的const修饰，确保自动填充系统能正确与输入框交互：

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

  @override
  State<LoginPage> createState() => _LoginPageState();
}

class _LoginPageState extends State<LoginPage> {
  final _usernameController = TextEditingController();
  final _passwordController = TextEditingController();

  @override
  void dispose() {
    _usernameController.dispose();
    _passwordController.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: AutofillGroup(
          child: SizedBox(
            width: 350,
            child: Column(
              mainAxisSize: MainAxisSize.min,
              children: [
                TextField(
                  controller: _usernameController,
                  autofillHints: const [AutofillHints.username],
                  decoration: const InputDecoration(hintText: "Username"),
                ),
                const SizedBox(height: 16),
                TextField(
                  controller: _passwordController,
                  obscureText: true,
                  autofillHints: const [AutofillHints.password],
                  decoration: const InputDecoration(hintText: "Password"),
                ),
                const SizedBox(height: 24),
                ElevatedButton(
                  onPressed: () {
                    TextInput.finishAutofillContext();
                    // 此处添加你的登录逻辑
                  },
                  child: const Text("Log In"),
                )
              ],
            ),
          ),
        ),
      ),
    );
  }
}

关键修改点 #

• 为用户名、密码输入框分别添加TextEditingController，让自动填充系统能直接更新输入框内容
• 移除Scaffold及子组件的const修饰，因为控制器无法被const初始化
• 添加间距组件优化表单布局，提升用户体验
• 确保TextInput.finishAutofillContext()在登录按钮点击时被调用，完成自动填充上下文的收尾

额外排查点 #

如果修复后问题仍存在：

• 检查iOS设备的设置→密码→自动填充密码是否已开启
• 确认设备已保存对应的账户密码条目
• 升级Flutter到最新稳定版本，旧版本可能存在iOS 17的适配缺陷

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