数据自愈迁移 + 后端同步幂等,版本号 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
+8 -14
View File
@@ -1,25 +1,15 @@
const api = require('./utils/api')
const storage = require('./utils/storage')
const sync = require('./utils/sync')
const migrate = require('./utils/migrate')
App({
onLaunch() {
const logs = wx.getStorageSync('logs') || []
logs.unshift(Date.now())
wx.setStorageSync('logs', logs)
this.initData()
// 先修一遍本地数据,再走网络流程
migrate.run()
this.getUserOpenId()
},
initData() {
const persons = wx.getStorageSync('persons') || []
const anniversaries = wx.getStorageSync('anniversaries') || []
if (persons.length === 0 && anniversaries.length === 0) {
console.log('初始化数据结构')
}
},
// 获取 openid:调自建后端 /api/login
async getUserOpenId() {
let openid = wx.getStorageSync('openid')
@@ -38,7 +28,11 @@ App({
// 拿到 openid 后,本地无数据时从云端拉一次(新设备/重装恢复场景)
const pulled = await storage.pullFromCloudIfEmpty()
if (pulled) console.log('已从云端恢复数据')
if (pulled) {
console.log('已从云端恢复数据')
// 云端可能存着老版本写上去的坏数据,拉回来后再修一遍(run 是幂等的)
migrate.run()
}
// flush 之前同步失败的待重试队列
sync.flush()