Firebase Realtime Database为何有时推送全集合而非仅更新数据？

问题背景 #

使用Go语言基于firego库订阅Firebase Realtime Database根路径“/”，正常仅接收变更数据（如示例中仅Data A3相关内容），但偶尔会收到整个集合的全量数据。

数据库结构 #

-- my collection
    -- Data A
        -- Data A1
            -- Data A2
                -- Data A3
                    - Key A31
                    - Key A32
                    - Key A33
                    - Key A34
    -- Data B
        ...

核心监听代码 #

conf, err := google.JWTConfigFromJSON(verifyKeyByte, UserinfoEmailScope, FirebaseDatabaseScope)
if err != nil {
    panic(err)
}
realtimeFirebaseURL := firego.New(fmt.Sprintf("%s", resource.FirebaseConfig.URL), conf.Client(oauth2.NoContext))
notifications := make(chan firego.Event)
if err := realtimeFirebaseURL.Watch(notifications); err != nil {
    panic(err)
}
defer realtimeFirebaseURL.StopWatching()
round := 1
resource.WatchNotifications(notifications, conf, realtimeFirebaseURL, round)

注：resource.WatchNotifications()为自定义的通知读取函数

可能的触发原因 #

• 长连接重连：监听依赖的长连接因网络波动、服务器端断开（负载均衡切换、会话超时）等原因中断，客户端重连时会同步全量数据以保证状态一致，这是Firebase监听的正常兜底逻辑。
• 身份令牌过期重连：JWT令牌过期后，firego自动刷新令牌并重建监听会话，新会话无之前的增量同步上下文，会重新拉取全量数据。
• 根路径大规模变更：若通过Set等操作覆盖整个根节点，或服务端因维护、故障恢复触发数据一致性校验，客户端会收到全量数据快照。
• firego库版本bug：部分旧版本firego在处理增量变更标记失败时，会回退到全量同步，建议检查当前使用版本是否存在此类已知问题。
• 客户端上下文丢失：程序意外重启、监听实例被重新创建且未复用同步标记（如last sync timestamp），会导致监听从头拉取全量数据。

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