WebAuthn PRF在Chromium浏览器标签页正常运行但macOS已安装PWA中无法获取PRF结果的问题排查

这绝对不是 macOS Chromium 独立 PWA 模式下的预期行为——PRF 作为 WebAuthn 的标准扩展，理应在同域名的 PWA 和普通标签页中表现一致。你遇到的问题更可能是 Chromium 对 PWA 环境下 WebAuthn 扩展支持的兼容性缺陷，或者是配置细节上的遗漏。下面是具体的分析和解决思路：

可能的原因 #

1. PWA 环境的权限隔离限制
   Chromium 的独立 PWA 运行在一个轻度隔离的沙箱环境中，部分 WebAuthn 扩展的权限可能没有被正确授予。虽然你的代码已经声明了 prf 扩展，但 PWA 环境可能需要更明确的触发条件来启用 PRF 功能。

2. 旧版本 Chromium 的支持缺失
   PRF 是 WebAuthn 相对较新的特性（Chrome 109+ 才稳定支持），如果你的 Chromium 版本偏旧，可能在 PWA 模式下存在未修复的兼容性 bug，导致 PRF 扩展无法正常工作。

3. 凭证配置的细微差异
   你使用的 residentKey: "required" 和 authenticatorAttachment: "platform" 在普通标签页中没问题，但 PWA 环境下可能需要更明确的参数声明，比如显式指定 rpId，避免环境识别偏差。

排查与解决步骤 #

1. 升级到最新版 Chromium/Chrome #

优先把浏览器升级到当前稳定版（Chrome 118+ 最佳），很多早期版本的 PWA WebAuthn 扩展缺陷已经被修复。

2. 检查 PWA 安装与 Manifest 配置 #

确保你的 PWA 是通过标准的 manifest.json 安装的，且 manifest 中包含正确的显示模式声明：

{
  "display": "standalone",
  "start_url": "/",
  "name": "Biometric Demo"
}

非标准的安装方式（比如手动创建快捷方式）可能导致权限或环境识别异常。

3. 显式指定关键参数 #

修改你的 getWithPrf 函数，显式添加 rpId 参数，避免 PWA 环境对域名的识别偏差：

async function getWithPrf(rawId) {
 const label = new TextEncoder().encode("bio-demo-prf-label-v1");
 const publicKey = {
 challenge: crypto.getRandomValues(new Uint8Array(32)),
 allowCredentials: [{ type: "public-key", id: rawId, transports: ["internal"] }],
 userVerification: "required",
 rpId: rpId, // 显式指定依赖方ID
 extensions: { prf: { eval: { first: label } } },
 timeout: 60000
 };
 const assertion = await navigator.credentials.get({ publicKey });
 const ext = assertion.getClientExtensionResults?.();
 console.log("get ext:", ext);
}

4. 验证 PRF 扩展的启用状态 #

在创建凭证阶段，可以尝试给 prf 扩展传递一个占位的 eval 参数（虽然标准中 create 阶段不需要，但可能帮助 PWA 环境识别扩展需求）：

// createCredential 中的 extensions 修改为
extensions: { prf: { eval: { first: new TextEncoder().encode("init") } } },

如果此时 getClientExtensionResults() 返回 prf.enabled: true，说明环境支持 PRF，只是之前的配置触发有问题。

5. 提交 Chromium Bug（如果以上都无效） #

如果升级和配置调整后仍然无法解决，这大概率是 Chromium 的 PWA 环境 bug，可以到 Chromium 的问题追踪平台提交报告，描述清楚你的环境（macOS 版本、Chromium 版本、PWA 安装方式）和复现步骤。

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