解决PWAsForFirefox扩展卡在"连接器安装"阶段的问题

问题背景

PWAsForFirefox是一个让Firefox浏览器支持渐进式Web应用(PWA)的扩展项目。近期部分Windows用户在安装过程中遇到了一个常见问题：扩展在"连接器安装"阶段停滞不前，即使已安装连接器也无法继续。

问题表现

用户报告的主要症状包括：

1. 安装扩展后，在同意协议并安装软件包后卡在"连接器安装"界面
2. 等待或重启浏览器均无法解决问题
3. 影响版本包括2.13.1和2.13.2
4. 通过WPM、Chocolatey或MSI安装方式都会出现

根本原因分析

经过技术排查，发现该问题主要由以下两种情况导致：

1. 注册表冲突：系统同时存在用户级(HKCU)和系统级(HKLM)的安装注册表项，导致扩展无法正确识别连接器位置
2. 残留文件：先前安装的用户级连接器未被完全卸载，残留文件干扰了新安装的连接器

详细解决方案

方法一：清理注册表项

1. 按下Win+R，输入regedit打开注册表编辑器
2. 导航至以下路径并删除相关项：
   • HKEY_CURRENT_USER\Software\filips\FirefoxPWA
   • HKEY_CURRENT_USER\Software\Mozilla\NativeMessagingHosts\firefoxpwa
3. 检查系统级注册表项是否指向正确路径：
   • HKEY_LOCAL_MACHINE\Software\Mozilla\NativeMessagingHosts\firefoxpwa的默认值应为C:\Program Files\FirefoxPWA\firefoxpwa.json

方法二：完全卸载后重新安装

1. 通过控制面板卸载所有PWAsForFirefox相关程序
2. 手动删除残留文件夹：
   • 用户级安装路径：C:\Users\{用户名}\AppData\Local\Programs\FirefoxPWA
   • 系统级安装路径：C:\Program Files\FirefoxPWA
3. 重新下载最新版本进行安装，推荐选择"为所有用户安装"选项

方法三：统一注册表路径

如果发现用户级和系统级注册表路径不一致：

1. 确保HKCU和HKLM下的firefoxpwa项都指向同一路径
2. 推荐统一指向系统级安装路径：C:\Program Files\FirefoxPWA\firefoxpwa.json

进阶排查

如果上述方法仍不能解决问题，可以：

1. 检查扩展日志获取详细错误信息
2. 确认连接器JSON文件实际存在于注册表指向的路径
3. 确保当前用户对相关路径有读写权限

预防措施

为避免此类问题再次发生，建议：

1. 安装前彻底卸载旧版本
2. 优先选择系统级安装而非用户级安装
3. 定期检查注册表中是否存在冲突项

总结

PWAsForFirefox连接器安装问题通常源于注册表配置冲突或残留文件。通过清理注册表、统一安装路径或完全重装，大多数情况下都能解决。理解Windows应用程序的安装机制和注册表工作原理，有助于更快定位和解决此类问题。