Floccus项目在Firefox私有窗口中的Git同步问题分析

问题背景

Floccus是一款优秀的浏览器书签同步工具，支持通过Git仓库实现跨设备书签同步。近期有用户反馈在Windows 11系统下的Firefox浏览器中使用Floccus进行Git同步时遇到错误，具体表现为"数据库不允许变更操作"的错误提示。

问题现象

当用户在Firefox 131.0.2版本中配置Floccus 5.3.1与BitBucket仓库同步时，控制台显示以下错误日志：

2024-10-14T22:57:44.401Z Starting sync process for account Vince
2024-10-14T22:57:44.588Z onSyncStart: begin
2024-10-14T22:57:44.600Z (git) init
2024-10-14T22:57:44.601Z onSyncFail
2024-10-14T22:57:44.601Z Syncing failed with A mutation operation was attempted on a database that did not allow mutations.

问题根源

经过分析，该问题与Firefox的私有浏览模式(PBM)特性有关。Firefox的私有浏览模式出于隐私保护考虑，默认禁用了IndexedDB功能。而Floccus的Git同步功能恰恰依赖IndexedDB来存储临时数据和执行同步操作。

解决方案

1. 禁用私有浏览模式：最简单的解决方案是关闭Firefox的私有浏览模式。用户可以在Firefox设置中检查是否默认启用了私有窗口，并调整为常规浏览模式。

2. 初始化Git仓库：有用户报告可以通过预先"水合"(hydrate)Git分支来解决此问题。具体做法是手动将当前书签导出为bookmarks.xbel文件，然后将其推送到Git仓库中建立初始提交。这种方法适用于新建的空白仓库。

技术细节

Floccus的Git同步实现依赖于浏览器提供的IndexedDB API来管理同步过程中的临时数据。在私有模式下，Firefox会限制以下操作：

• 创建或修改IndexedDB数据库
• 执行任何可能持久化存储的操作
• 保留浏览器关闭后的任何数据

这种限制是Firefox隐私保护设计的一部分，并非Floccus本身的缺陷。开发者已确认这是预期行为，短期内不会改变。

最佳实践建议

对于需要在多设备间同步书签的用户，我们建议：

1. 使用常规浏览模式运行Firefox
2. 如果必须使用私有浏览，可以考虑其他同步方式(如WebDAV)
3. 对于新配置的Git仓库，建议先手动创建初始提交
4. 定期检查同步日志，确保同步过程正常完成

总结

Floccus项目在Firefox私有窗口中的Git同步限制是由浏览器安全策略导致的。用户可以通过调整浏览器设置或预先初始化仓库来解决此问题。理解这一限制有助于用户更好地规划书签同步策略，确保数据在不同设备间安全可靠地同步。