数据自愈迁移 + 后端同步幂等,版本号 v2.1.7 → v2.1.8
部署到群晖 / deploy (push) Successful in 57s

后端(server/src/index.js)——两处同步幂等:

1. deleteAnniversary 删除不存在的记录时返回 success:true。
   原先返回 false,被前端 sync.js:34 当作失败重新入队,那条删除会永远留在
   pending_sync_queue 里每次启动重试且永远清不掉。

2. updateAnniversary / updatePerson 在记录不存在时退化为插入(upsert)。
   同一类问题:本地才是主真相源,若某条记录当初的 add 没同步成功,
   之后所有 update 都会失败并无限重试。

前端 —— 新增 utils/migrate.js,在 app.js onLaunch 执行:

3. 补齐老数据缺失的农历字段。早期 lunar_birthday 类型只记公历日期,
   没有 lunarMonth/lunarDay,这类记录会被安全降级成按公历算——不崩,但每年日期是错的。
   用它存的公历日期反算回农历补齐。

4. 为孤儿纪念日重建人员。部分纪念日的 personId 指向已不存在的人(历史上删人没级联干净),
   首页按 persons 遍历所以隐形,日历页按 anniversaries 遍历会显示成「未知」。
   用记录自带的 personName 重建,并沿用原 personId,纪念日无需改动。

迁移放在客户端而非后端跑 SQL:本地 wx.Storage 是主真相源,改服务端会被客户端同步覆盖。
每次启动都跑而非记版本号:函数是纯检测式的,无坏数据时零写入零请求,
还能顺带覆盖「从云端拉回坏数据」的情况。顺便把原本是死代码的 initData() 替换掉。

⚠️ 本次后端有改动,需要重新部署;部署顺序应为先后端、后小程序。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
yuming
2026-08-15 15:55:44 +08:00
parent 1943fd5c1a
commit e9c7330f31
6 changed files with 1726 additions and 18 deletions
+11 -3
View File
@@ -117,9 +117,13 @@ function addAnniversary(openid, anniv) {
return { success: true, id }
}
// 记录不存在时退化为插入(upsert)。
// Why:本地 wx.Storage 才是主真相源,云端只是备份。若某条记录当初的 add 没同步成功,
// 之后所有 update 都会失败,并卡在前端 pending_sync_queue 里每次启动无限重试。
// 与 deleteAnniversary 的幂等处理是同一类问题。
function updateAnniversary(openid, anniv) {
const existing = db.prepare('SELECT * FROM anniversaries WHERE id = ? AND openid = ?').get(anniv.id, openid)
if (!existing) return { success: false, error: '纪念日不存在' }
if (!existing) return addAnniversary(openid, anniv)
const merged = {
...existing,
@@ -136,9 +140,12 @@ function updateAnniversary(openid, anniv) {
return { success: true }
}
// 删除是幂等的:记录本来就不存在时也算成功。
// Why:前端 sync.js 把 success:false 当作失败重新入队,若这里对「已不存在」返回 false,
// 那条删除操作会永远留在 pending_sync_queue 里,每次启动重试且永远清不掉。
function deleteAnniversary(openid, id) {
const info = db.prepare('DELETE FROM anniversaries WHERE id = ? AND openid = ?').run(id, openid)
return { success: info.changes > 0 }
return { success: true, deleted: info.changes }
}
function syncAnniversaries(openid, list) {
@@ -180,9 +187,10 @@ function addPerson(openid, person) {
return { success: true, id: row.id }
}
// 同 updateAnniversary:记录不存在时退化为插入,避免同步队列里的 update 永远重试
function updatePerson(openid, person) {
const existing = db.prepare('SELECT * FROM persons WHERE id = ? AND openid = ?').get(person.id, openid)
if (!existing) return { success: false, error: '人员不存在' }
if (!existing) return addPerson(openid, person)
const merged = { ...existing, ...person, openid, updateTime: Date.now() }
const sets = PERSON_FIELDS.filter(f => f !== 'id' && f !== 'openid' && f !== 'createTime')
.map(f => `${f} = @${f}`).join(', ')