macOS版Firefox无法触发Passkeys登录问题求助

1. 确认Firefox版本兼容性 #

macOS Firefox对Passkey Conditional UI的正式支持从版本116开始，先检查当前Firefox版本是否低于该版本，若低于则直接升级到最新稳定版后重试。

2. 修正Autocomplete属性配置 #

用户名和密码字段的autocomplete属性必须严格遵循标准规范，不能使用自定义占位符：

• 用户名字段：autocomplete="username webauthn"
• 密码字段：autocomplete="current-password webauthn"
  非标准标识会导致Firefox无法识别Passkey触发条件。

3. 调整条件式调用的时机 #

Firefox对Conditional UI的调用时机有严格限制：

• 必须在页面完全加载完成后发起调用，比如放在DOMContentLoaded或window.load事件回调中，避免在页面未就绪时提前执行。
• 确保调用是在页面初始化阶段同步触发，不要在表单字段focus事件中延迟调用。

4. 检查Firefox的Passkey权限设置 #

打开Firefox设置，进入「隐私与安全」→「密码」，确认：

• 已勾选「自动保存登录信息」
• 已启用「允许网站通过Passkey登录」选项
  部分用户可能手动关闭了相关权限，导致Conditional UI无法触发。

5. 完善调用参数与错误捕获 #

在调用navigator.credentials.get时，确保参数结构合规并添加错误捕获：

navigator.credentials.get({
  publicKey: {
    challenge: Uint8Array.from(/* 你的挑战值 */),
    rpId: /* 与当前页面域名一致的注册域名，如example.com */,
    userVerification: "preferred",
    mediation: "conditional"
  }
})
.then(credential => {
  // 处理返回凭证
})
.catch(err => {
  // 捕获并输出错误信息，排查参数或权限问题
  console.error("Conditional get failed:", err);
});

• 必须保证rpId与当前页面域名完全匹配（不能带协议或路径），否则Firefox会拒绝处理。
• 之前的调用可能因参数错误静默失败，添加catch块可暴露问题根源。

6. 排除第三方扩展干扰 #

检查页面是否存在表单自动填充脚本、密码管理器插件或隐私类扩展（如广告拦截器），这些工具可能干扰Firefox的Conditional UI触发逻辑。可尝试在Firefox隐私浏览模式下测试，若隐私模式正常，说明是第三方扩展导致的冲突。

7. 关于Firefox Focus的差异说明 #

iPhone的Firefox Focus基于WebKit内核，其Passkey支持依赖iOS系统的WebAuthn实现；而macOS Firefox使用Gecko内核，两者实现逻辑不同，这也是Focus能正常工作但macOS Firefox出现问题的原因。

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