删除 CalDAV 账号时一并清除其系统日历镜像本

问题:在 App 里删除一个 CalDAV 账号后,之前镜像进系统日历的日历本
(synccalendar.mirror.<accId>-<hash> 账户) 仍留在系统日历里,形成幽灵账户。
真机实测确认:账号 1789564608312 已删,其名下 13 个镜像账户仍在(KEEP)。

根因:
- AccountsPage.confirmDeleteAccount 只清账号配置+本地库+设置,完全不碰系统日历;
- 自动兜底也失效:SystemCalendarMirror.syncNow 在解析不到任何选中本时提前 return,
  删完账号后正是此状态,purgeOrphans 永不执行。

修复:
- SystemCalendarMirror.removeByAccount(accId):按 'mirror.<accId>-' 前缀删除该账号全部
  镜像账户(兼容历史 '<accId>_' 桶名),逐个独立 try/catch + 清空日程降级;
  绝不按 displayName 匹配 —— 不同账号下的同名日历本不会误删;同步清快照与选中项设置。
- AccountsPage 删除账号时先 removeByAccount(必须在改账号配置前,否则 bookId 解析不出)。
- EditAccountPage 取消勾选日历本时删除其镜像账户(用 href 算稳定 bookId)。
- SettingsPage 账号库重置时 removeAll。
- syncNow 提前 return 前加 purgeOrphanAccountMirrors 兜底,带安全阀(账号列表为空即跳过,
  防读失败误删全量)。
This commit is contained in:
2026-10-09 08:47:50 +08:00
parent 32162b8f04
commit c76c78b8a6
4 changed files with 234 additions and 3 deletions
@@ -320,6 +320,14 @@ export class SystemCalendarMirror {
}
// ⭐ 选中项一律走**稳定标识** bookId(由服务器 href 派生),并顺带迁移历史 calKey 选中项
const refs: BookRef[] = await SystemCalendarMirror.selectedBookRefs(context);
// ⭐ 兜底:无论有没有选中本,都顺手清掉"账号已删除"的孤儿镜像账户。
// 否则"删掉一个账号后系统日历里还留着它的日历本"永远不会被自动修掉
// (旧代码在这里 return 之前根本不做清理,这正是本次要修的 bug)。
try {
await SystemCalendarMirror.purgeOrphanAccountMirrors(context);
} catch (err) {
// 兜底清理失败不影响正常镜像
}
if (refs.length === 0) {
LogUtil.write('镜像中止:未选择要镜像的日历本(或全部是备份目标本)');
return res;
@@ -421,6 +429,175 @@ export class SystemCalendarMirror {
return SystemCalendarMirror.removeById(context, bookId);
}
/**
* ⭐ 删除**某一个 DAV 账号**名下的全部镜像账户(在 App 里删除该账号时调用)。
*
* 背景(用户反馈):删掉一个 CalDAV 账号后,之前镜像进系统日历的那些"日历本"
* 仍然留在系统日历里(幽灵账户 + 幽灵日程)。旧代码只清了账号配置与本地库,
* 完全没碰系统日历侧;而自动兜底(syncNow 里的 purgeOrphans)在"解析不到任何选中本"时
* **会提前 return**,所以删完账号后根本不会触发兜底清理。
*
* ⭐ **绝不按日历本显示名匹配**:镜像账户名是 `synccalendar.mirror.<bookId>`,
* 而 bookId = `<accId>-<href哈希>` 天然带账号前缀。因此这里只按
* `synccalendar.mirror.<accId>-` 前缀匹配 —— 即使**不同账号下有同名日历本**
* (比如两个账号各有一个「工作」),它们的 bookId 不同、账户名也不同,绝不会删错。
*
* 幂等;未授权 / 无匹配时返回 0。每个账户独立 try/catch,一个失败不影响其它。
*
* @returns 成功删除的镜像账户数
*/
static async removeByAccount(context: common.Context, accId: string): Promise<number> {
if (accId === '' || !await SystemCalendarMirror.hasPermission()) {
return 0;
}
// ⭐ 账户名前缀 = 公共前缀 + accId + '-'(bookId 里的分隔符)。
// 带尾随 '-' 才不会把 accId「123」错配到 accId「1234」的账户上。
// 同时兼容**历史**账户名(旧版用 calKey 做桶 → `synccalendar.mirror.<accId>_<序号>`),
// 同样带尾随 '_' 分隔符,宁可多清一批脏账户,也不按显示名乱删。
const prefix: string = `${SystemCalendarMirror.ACCOUNT_PREFIX}${accId}-`;
const legacyPrefix: string = `${SystemCalendarMirror.ACCOUNT_PREFIX}${accId}_`;
let removed: number = 0;
const buckets: string[] = [];
try {
const cm: calendarManager.CalendarManager = calendarManager.getCalendarManager(context);
const all: calendarManager.Calendar[] = await cm.getAllCalendars();
for (const cal of all) {
const name: string = cal.getAccount().name;
if (!name.startsWith(prefix) && !name.startsWith(legacyPrefix)) {
continue; // 不属于本账号(含其它账号的同名日历本)→ 绝不动
}
const bucket: string = name.substring(SystemCalendarMirror.ACCOUNT_PREFIX.length);
try {
await cm.deleteCalendar(cal);
removed++;
buckets.push(bucket);
LogUtil.write(`删除账号 ${accId}:已删除镜像账户 id=${cal.id} name=${name}`);
} catch (err) {
const e1 = err as BusinessError;
LogUtil.write(`删除账号 ${accId}:删除镜像账户失败(重试) id=${cal.id} name=${name}: ${e1.message}`);
// 降级:先清空账户内全部日程,再删一次(与 purgeOrphans 同策略)
try {
const evs: calendarManager.Event[] = await cal.getEvents();
const ids: number[] = [];
for (const ev of evs) {
if (ev.id !== undefined) {
ids.push(ev.id);
}
}
if (ids.length > 0) {
await cal.deleteEvents(ids);
}
} catch (err2) {
LogUtil.write(`删除账号 ${accId}:清空镜像账户日程失败 id=${cal.id}: ${(err2 as BusinessError).message}`);
}
try {
await cm.deleteCalendar(cal);
removed++;
buckets.push(bucket);
LogUtil.write(`删除账号 ${accId}:已删除镜像账户(清空后重试成功) id=${cal.id} name=${name}`);
} catch (err3) {
LogUtil.write(`删除账号 ${accId}:镜像账户删除失败(最终) id=${cal.id} name=${name}: ${(err3 as BusinessError).message}`);
}
}
}
} catch (err) {
LogUtil.write(`删除账号 ${accId}:读取系统日历账户列表失败 ${(err as BusinessError).message}`);
}
// 清掉这些本在镜像快照里的残留(bucket = bookId)
for (const b of buckets) {
await MirrorSnapshot.removeByCalKey(context, b);
}
// 清掉"镜像选中项"里属于本账号的条目(防止残留脏 bookId 干扰下次选择/迁移)。
// ⚠️ 用 `${accId}-` / `${accId}_` 前缀过滤(同样带分隔符,避免误伤相似 accId)。
try {
const ids: string[] = await AppSettings.getMirrorBookIds(context);
const kept: string[] = ids.filter((id: string): boolean => !id.startsWith(`${accId}-`));
if (kept.length !== ids.length) {
await AppSettings.setMirrorBookIds(context, kept);
}
const legacy: string[] = await AppSettings.getMirrorKeys(context);
const keptLegacy: string[] = legacy.filter((k: string): boolean => !k.startsWith(`${accId}_`));
if (keptLegacy.length !== legacy.length) {
await AppSettings.setMirrorKeys(context, keptLegacy);
}
} catch (err) {
// 设置清理失败不影响账户删除结果,下次同步会再兜底
}
LogUtil.write(`删除账号 ${accId}:系统日历镜像清理完成,共删除 ${removed} 个镜像账户`);
return removed;
}
/**
* ⭐ 兜底:清理"账号已不存在"的孤儿镜像账户(同步时调用,防止删除路径万一漏掉)。
*
* ⚠️ **安全阀**:当前账号列表为空时**直接跳过** —— 无法区分"用户删光了账号"与
* "账号存储临时读失败返回空",后者若照常清理会把所有镜像账户误删。
* "删光账号"这种场景已由 `removeByAccount` / 重置账号库两条显式路径覆盖。
* 只要还剩至少一个账号,就只清"accId 前缀不在当前账号集合里"的那些 —— 精准、不会误伤。
*
* @returns 删除的账户数
*/
static async purgeOrphanAccountMirrors(context: common.Context): Promise<number> {
if (!await SystemCalendarMirror.hasPermission()) {
return 0;
}
let accounts: DavAccount[] = [];
try {
accounts = await AccountStore.loadAll(context);
} catch (err) {
return 0; // 读失败一律不动
}
if (accounts.length === 0) {
return 0; // 安全阀:见注释
}
const validAccIds: Set<string> = new Set<string>();
for (const a of accounts) {
validAccIds.add(a.id);
}
let removed: number = 0;
try {
const cm: calendarManager.CalendarManager = calendarManager.getCalendarManager(context);
const all: calendarManager.Calendar[] = await cm.getAllCalendars();
for (const cal of all) {
const name: string = cal.getAccount().name;
if (!name.startsWith(SystemCalendarMirror.ACCOUNT_PREFIX)) {
continue;
}
const bucket: string = name.substring(SystemCalendarMirror.ACCOUNT_PREFIX.length);
// bucket 形如 `<accId>-<hash>`;也兼容历史 `<accId>_<序号>`
const dash: number = bucket.indexOf('-');
const under: number = bucket.indexOf('_');
let sep: number = -1;
if (dash >= 0 && under >= 0) {
sep = Math.min(dash, under);
} else {
sep = dash >= 0 ? dash : under;
}
if (sep <= 0) {
continue; // 解析不出 accId → 不动(宁可留,不误删)
}
const accId: string = bucket.substring(0, sep);
if (validAccIds.has(accId)) {
continue;
}
try {
await cm.deleteCalendar(cal);
removed++;
LogUtil.write(`兜底清理孤儿镜像账户(账号 ${accId} 已删除) id=${cal.id} name=${name}`);
} catch (err) {
LogUtil.write(`兜底删除孤儿镜像账户失败 id=${cal.id} name=${name}: ${(err as BusinessError).message}`);
}
await MirrorSnapshot.removeByCalKey(context, bucket);
}
} catch (err) {
LogUtil.write(`兜底清理孤儿镜像账户:读取系统日历账户失败 ${(err as BusinessError).message}`);
}
if (removed > 0) {
LogUtil.write(`兜底清理孤儿镜像账户完成:删除 ${removed} 个`);
}
return removed;
}
/* ==================== 单个日历本 ==================== */
/**
@@ -1224,6 +1401,18 @@ export class SystemCalendarMirror {
return `${(h1 >>> 0).toString(36)}${(h2 >>> 0).toString(36)}`;
}
/**
* ⭐ 由 `<accId> + href` 算出稳定标识 bookId(= `<accId>-<href哈希>`)。
* 与 `listBooks()` 内部算法**完全一致**,供编辑账号页在"取消勾选某个日历本"时
* 立即算出它的 bookId 并删掉对应镜像账户用(此时账号配置已被改写,listBooks 已查不到它)。
* href 为空时退回 calKey(与 listBooks 的兜底口径一致)。
*/
static bookIdOf(accId: string, href: string, fallbackCalKey: string): string {
return href !== ''
? `${accId}-${SystemCalendarMirror.stableHash(href)}`
: fallbackCalKey;
}
/** 用账号信息补全日历本名与颜色(需要异步加载账号) */
static async loadBookLabels(context: common.Context, keys: string[]): Promise<BookInfo[]> {
const out: BookInfo[] = [];
+18 -2
View File
@@ -10,6 +10,7 @@ import { EventDb } from '../common/EventDb';
import { LogUtil } from '../common/LogUtil';
import { AppSettings } from '../common/AppSettings';
import { ScreenKeeper } from '../common/ScreenKeeper';
import { SystemCalendarMirror } from '../common/SystemCalendarMirror';
@Entry
@Component
@@ -142,13 +143,24 @@ struct AccountsPage {
});
}
/** 执行删除:账号配置 + 该账号全部本地日程/待办 */
/** 执行删除:账号配置 + 该账号全部本地日程/待办 + 该系统日历中该账号的全部镜像日历本 */
private async confirmDeleteAccount(acc: DavAccount): Promise<void> {
const context = this.getUIContext().getHostContext();
if (context === undefined) {
return;
}
try {
// ⭐ 先清系统日历里属于**本账号**的镜像日历本(按 bookId 里的 accId 前缀匹配,
// 绝不按显示名 → 不同账号的同名日历本不会误删)。
// 必须在改账号配置**之前**做:一旦账号配置被删,bookId 就再也解析不出来,
// 那些幽灵账户就永远清不掉了(这正是本次要修的 bug)。
let mirrored: number = 0;
try {
mirrored = await SystemCalendarMirror.removeByAccount(context, acc.id);
} catch (err) {
// 系统日历清理失败不阻断账号删除(用户至少能删掉账号)
LogUtil.write(`删除账号 ${acc.id}:清理系统日历镜像失败 ${(err as BusinessError).message}`);
}
this.accounts = this.accounts.filter((a: DavAccount): boolean => a.id !== acc.id);
// force=true:删除最后一个账号时列表为空是合法场景,允许覆盖
await AccountStore.saveAll(context, this.accounts, true);
@@ -156,7 +168,11 @@ struct AccountsPage {
await EventDb.deleteAccountEvents(context, acc.id);
await AppSettings.cleanupAccountSettings(context, acc.id);
this.getUIContext().getPromptAction()
.showToast({ message: `「${acc.name}」已删除` });
.showToast({
message: mirrored > 0
? `「${acc.name}」已删除,并清除系统日历中 ${mirrored} 个镜像日历本`
: `「${acc.name}」已删除`
});
} catch (err) {
const e = err as BusinessError;
this.getUIContext().getPromptAction()
@@ -242,6 +242,21 @@ struct EditAccountPage {
const pruned: number = await EventDb.pruneByHrefs(context, target.id, removedHrefs);
LogUtil.write(`编辑账号保存:取消勾选/已失效 ${removedHrefs.length} 个日历本,清理本地日程 ${pruned} 行`);
}
// ⭐ 被取消勾选的日历本,其系统日历镜像账户也要一并删掉(否则取消同步后系统日历仍有幽灵账户)。
// 此时账号配置即将被改写、listBooks 已解析不到它,故用 href 直接算稳定 bookId(与镜像侧同算法)。
// ⚠️ 用稳定 bookId 删 —— 不同账号下有同名日历本时,bookId 里带 accId 前缀,绝不会删错。
for (let oi: number = 0; oi < oldHrefs.length; oi++) {
const oh: string = oldHrefs[oi];
if (newHrefSet.has(oh)) {
continue;
}
const bookId: string = SystemCalendarMirror.bookIdOf(target.id, oh, `${target.id}_${oi}`);
try {
await SystemCalendarMirror.removeById(context, bookId);
} catch (err) {
// 镜像账户删除失败不阻断保存(下次镜像前的孤儿清理还会兜底)
}
}
const remapPairs: Array<[string, string]> = [];
for (let oi: number = 0; oi < oldHrefs.length; oi++) {
const oldNorm: string = DavClient.normalizeHref(oldHrefs[oi]);
+12 -1
View File
@@ -682,9 +682,20 @@ struct SettingsPage {
return;
}
try {
// ⭐ 账号库整体重置 = 所有账号都没了 → 系统日历里的全部镜像账户也应一并清除
// (否则会留下一堆无主的幽灵日历本,且再无人能对应回账号)。
// 未授权/无镜像时返回 0,不影响重置本身。
let mirrored: number = 0;
try {
mirrored = await SystemCalendarMirror.removeAll(this.context);
} catch (err) {
// 清理失败不阻断重置
}
await AccountStore.resetVault(this.context);
this.getUIContext().getPromptAction().showToast({
message: '账号库已重置,请重新添加账号'
message: mirrored > 0
? `账号库已重置,并清除系统日历中 ${mirrored} 个镜像日历本`
: '账号库已重置,请重新添加账号'
});
} catch (err) {
this.getUIContext().getPromptAction().showToast({