跳转至

ISSUE-0135 · 上传出口零闸 + 一个被拦下的错误修法

原始缺陷:闸挂错了边界(第七次同形状复发)

ISSUE-0125/0130/0132/0133 四刀都把「共享数据写入前必须 validate」解释成 writeContactRecord(写本地 IndexedDB)/ writeCloudRecords(云端拉回)。 但数据真正离开本机、成为别人可见的共享事实的边界是 flushContactPoolUploads → getPendingUploads(where { syncedAt: 0, source: 'local' } 的裸 select)→ 逐字段直传 apiContactPoolUpload。

⇒ 本地写入端的闸只保护「从此刻起新抓的行」;上传端搬的是整个存量。 同一份数据两个消费者,一个够得到判据、一个够不到 —— 与前四次同一形状。

触发条件(诚实记录):enableCloudSync 默认 false、服务端未上线、 ensureAuth() 会失败 ⇒ 今天一条都传不出去。这是引信,不是在产泄漏。 且接收端 writeCloudRecords 已对三类清洗 ⇒ 对 ≥v0.10.156 的对端扩散被挡住。

🔴 首版修法引入了比原缺陷更危险的东西 —— 被双路对抗审拦下

第一版(未进 main)在 getPendingUploads 里加了清洗并写回:

病灶

getPendingUploads 名义上读取待上传行,上一轮却在构造上传 payload 前调用 connection.update,把过滤后的 emails、phones、socials 覆盖回本地库。 这发生在网络请求之前:API 失败时,用户本地唯一副本也已经丢失。

这还绕过了项目既有止损边界:cleanPollutedContactPool 的存量写回有 dry-run, 并由 ENABLE_CONTACT_POOL_COORDINATE_CLEANUP = false 默认关闭;上传调度不应成为 另一条无预演、无知情的存量清理通道。

修复

  1. getPendingUploads 只返回内存中的清洁投影,不再写库。
  2. 投影仍有至少一个 email、phone 或 social 的行才上传。
  3. 投影全空的行不发送空 payload,只推进 syncedAt,并写 cloud-sync/upload-skip-empty 系统日志;原始三个联系方式字段逐字保留。
  4. API 失败时,可上传行的所有本地字段和 syncedAt 均保持不变,下轮重试。

这里不复用 cleanPollutedContactPool:该函数的职责是用户可预演后清理存量;上传出口 只负责决定什么能离开本机。把两者绑定会让启用云同步隐式等价于批准本地清理。

空转与残余边界

全空投影通过 syncedAt 进入跳过终态,不再占住按 scrapedAt 取出的最老 200 条, 所以不会每 30 秒重复过滤同一批空行。代价是当前 schema 没有独立 skipReason, 只能从系统日志区分“上传成功”和“因出口过滤为空而跳过”;数据本身仍完整留在本地。

出口闸只能拦住现有纯字符串判据识别出的脏值。基准集明确保留的 KNOWN_MISS_ambiguous 20 条仍会上行;用户可配置的邮箱黑名单/噪音偏好也不属于 “数据损坏”判据,仍可上行。任何尚未被 isPhoneFitForPool、 isEmailLikelyBroken、isSocialUrlFitForPool 识别的新型假阴性同样是残余口子。

验证

  • fixtures-coord-noise.json 全量:MUST_DROP 56、MUST_KEEP 38、KNOWN_MISS 20、误杀 0。
  • 变异恢复上传读取写回:Tests 2 failed | 1 passed (3)。
  • 变异删除全空行状态推进:Tests 1 failed | 2 passed (3)。