Flutter iOS端登录凭据自动填充异常问题排查求助

问题现象 #

• iOS端键盘浮层不直接展示已保存的凭据，仅提供密码管理器入口，需手动选择才能填入邮箱、密码字段
• 每次登录后都会弹出系统保存凭据确认框，即便该凭据已存在

相关代码与配置 #

登录表单代码 #

Container _buildLoginForm(BuildContext context) {
  return Container(
      padding: const EdgeInsets.all(20.0),
      child: AutofillGroup(
          onDisposeAction: AutofillContextAction.commit,
          child: Wrap(runSpacing: 10, children: [
            TextField(
              autofillHints: const <String>[AutofillHints.username], 
              decoration: getTextFieldDecoration("E-Mail"), 
              controller: _emailController),
            TextField(
                obscureText: true,
                autofillHints: const <String>[AutofillHints.password],
                decoration: getTextFieldDecoration("Password"),
                controller: _passwordController,
                onEditingComplete: () => _handleLogin()),
            ElevatedButton(
              onPressed: () => _handleLogin(),
              child: const Text("Login"),
            )
          ])));
}

apple-app-site-association 配置 #

{
   "webcredentials":{
      "apps":[         "<TeamID>.<AppID>"      ]   },
   "applinks":{
      "apps":[ ],
      "details":[         {
            "appID":"<TeamID>.<AppID>",
            "paths":[ "*", "/" ]         }      ]   }
}

环境与已验证信息 #

• Flutter版本：3.10.6（也试过3.12.0）
• 测试设备：iPad Air2（iOS 15.7.7）
• 服务器日志显示apple-app-site-association已被正常访问，凭据已保存到对应域名，且可在Safari其他登录页正常访问
• 已尝试更换域名、AppID等配置，凭据保存正常但无法关联到Flutter输入字段

问题排查与解决方案方向 #

1. 调整AutofillHints匹配规则 #

iOS密码管理器对字段类型识别更严格，建议将邮箱字段的AutofillHints.username替换为AutofillHints.email，贴合iOS的识别逻辑：

TextField(
  autofillHints: const <String>[AutofillHints.email], 
  // 其他配置保持不变
)

2. 手动触发Autofill提交动作 #

当前onDisposeAction: AutofillContextAction.commit是在AutofillGroup销毁时提交，登录成功时可能未及时通知系统。建议在登录验证成功后手动提交：

void _handleLogin() async {
  // 执行登录逻辑，验证通过后
  await AutofillContext.current.commit();
  // 后续页面跳转等操作
}

3. 检查iOS端原生配置 #

• 确保Xcode的Signing & Capabilities中已开启AutoFill Credential Provider
• 在Info.plist中添加目标域名的关联配置：

<key>NSCredentialsProviderDomains</key>
<array>
  <string>你的目标域名.com</string>
</array>

4. 适配iOS 15.x版本特性 #

iOS 15.x的自动填充逻辑与后续版本有差异，可尝试以下调整：

• 给邮箱字段添加enableSuggestions: true
• 避免动态切换密码字段的obscureText状态，防止干扰自动填充识别

5. 确认域名匹配一致性 #

apple-app-site-association中的域名需为根域名（不带路径），且与登录请求对应的域名完全一致（包括HTTP/HTTPS、子域名），iOS会严格进行域名匹配。

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