Files
cbb-refresh-verify-795/docs/releases/2026-10-27-icdb-failure-lifecycle-and-recovery.md

6.6 KiB
Raw Permalink Blame History

r4 失败后 iCDB 断库:根因修复与受控恢复

分支:codex/icdb-lost-session-diagnostics。用户确认现场事故使用 r4 或更早版本。

工具侧根因

在 r4(11a2b2e)中,单项校验失败和监督器超时都会进入强制进程树清理:

  • DesktopWorker 设置 JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE,kill() 调用 TerminateJobObject,回退路径是 taskkill /T /F。
  • cleanup_verify_processes() 对目标 PCB 执行同样的强制进程树终止。
  • prepare_icdb_address() 会在 TCP 探测失败后移走地址文件。连通性失败 不能证明服务器已安全退出;移走地址也不能修复数据库中未完成的会话状态。

这条失败收尾路径能连带杀死 PCB 启动的 iCDB 服务器,打断数据库事务或关闭过程, 留下 dirty session。下次由其他机器打开时,iCDB 拒绝继续并要求 Repair, 与用户描述的“未校验成功后才出现失联消息”吻合。现有代码足以确认该缺陷, 但没有 200091-CBB 本次完整进程/数据库日志,不能确定具体中断的是哪次事务。

a11eb3c 已修掉主要 PCB 强杀路径;继续检查发现内容检查超时仍保留 taskkill /T /F,以及失败文档只保留在隐藏桌面、没有正常关闭尝试。 这些遗漏在本分支继续修复,不能让用户继续用 r4 的收尾逻辑测试。

本轮行为

  • 内容检查超时保留 importer 及原生子进程,使用文件承接输出,防止父进程 退出造成管道阻塞/断管;记录 PID、命令和退出状态并停止后续队列。
  • 校验超时/监督器丢失改为协作取消。阻塞中的原生调用先返回,再在操作边界 停止后续动作;不终止正在 Save 的助手。
  • 原生调用返回且已确认身份的失败文档,由 x86 助手核对 PRJ 和 PCB 名称后 执行 Close(False),释放引用后正常 Quit。若另一个文档仍活动则保留应用; 慢 Close 同样保留助手,不用强杀代替完成。
  • 写入前和成功前同时核对 Work、PCB 及中心库 SymbolLibs/__ReusableBlocksSymb 的地址所有权。隐藏 Library Manager 在失败 PCB 正常关闭后也请求正常关闭;所有权未知时继续停止批次。
  • 只读状态桥先关闭标准输入并等待 EOF 清理,避免正常退出也被立即终止。

自动 Repair 的范围

只有本轮明确的 ICDB_REPAIR_REQUIRED、完整会话身份、可映射到当前 Work/PCB PRJ 的数据库,才进入一次原生恢复尝试。TIMEOUT、未释放的 importer/PCB/Library Manager/助手、外部目标及路径歧义都不会启动 Repair。

恢复前通过 Windows 独占文件访问确认目标 icdb.dat 没有仍打开的客户端, 完整复制工程全部文件(包括数据库、锁、原备份、日志),逐项校验副本及 源文件集合。该副本与平日排除数据库的轻量 evidence 备份不同。

Repair worker 绑定监督进程和确切私有桌面。它从安装程序资源解析 Project → Repair,核对原生窗口中的完整 PRJ,只接受实际验证过的 Repair 确认文本。备份期间取消会阻止后续启动;原生 Repair 已经开始后, 超时或监督器丢失不会强制终止它。

恢复成功需要本次原生 PID 的诊断完成、数据库关闭、完整 Project Repair ZIP、原生进程正常退出及地址释放。满足后只重试一次完整校验,仍以 IsVerifiedReuseBlock READY/raw=1 为最终成功条件。原错误、原 evidence 和恢复结果保存在 recovery_attempts,完整修复备份保留。

共享符号库边界: 本机同版本 Project Backup 直接打开符号数据库目录时, 明确拒绝并要求 .prj。因此对 SymbolLibs/__ReusableBlocksSymb 的已损坏 数据库,本分支会报告 SHARED_DATABASE_REPAIR_UNSUPPORTED,不会改修一个 不相关的 Work 工程,也不会删地址/锁或猜测私有 ABI。正常关闭和共享所有权 检查用于防止再制造这类问题;已有共享库损坏仍需匹配该库的原生恢复入口。

实际验证

以下写入均针对本轮新副本,未修复或改动现场 200091-CBB 数据:

  • 真实 Windows 无害 importer/子进程试验:超时后均存活,后续队列停止。
  • x86 cscript 测试:核对身份、失败关闭用 Close(False)、不保存错误结果、 另有活动文档时不 Quit、Save 返回后响应取消。
  • 新 IP101GR 副本主动注入空闲时的同步失败:输出 FAILURE_CLOSE_OK、 FAILURE_QUIT_OK,随后确认 PCB 进程退出;失败结果保持 FAIL。
  • 同一隔离库随后正常校验:PASS/GREEN,Save/Close/退出和 READY (IsVerifiedReuseBlock, raw=1) 均确认。
  • 原生 Repair 模块真实执行:完整备份、Repair 确认、本 PID 的 dbcheck/ 数据库关闭日志、Project Repair ZIP 校验齐全,最终 REPAIRED、退出码 0。 这验证了原生恢复链,不代表复现并恢复了现场同一个 dirty session。
  • 完整自动恢复链:向隔离副本的首次校验注入合成失联错误,之后实际执行 正常关闭、完整备份和原生 Repair,再启动第二次真实校验,最终 PASS/GREEN、safe_to_continue=True。只启动两次校验 worker、一次 Repair; 原错误及 evidence 保留。没有故意破坏数据库,也没有恢复现场损坏库。
  • PyInstaller 目录包构建和冻结 GUI 生命周期冒烟通过;直接使用生成的 EXE 在另一个独立工程副本上运行 Repair worker,最终 REPAIRED、退出码 0。 因此原生修复入口也已验证能在冻结包内工作。
  • 原样本 21,011 个文件在上述试验前后 SHA-256 内容指纹一致。
  • 最终 Python 全量回归 448 项通过(含前次 417 项基线);仍有基线已有的 一条 pywinauto STA COM 模式提示。两组 PowerShell 测试、编译和 Git 空白检查通过。
  • 独立复查指出的未释放 importer 进入 Repair、备份期间取消、修复 worker 父进程丢失、共享 COM 应用退出等边界均已修正,并补充对应回归。

本地原始证据位于 diagnostics/icdb-auto-recovery-20261027,不随包发布。

分支试用包

本地 CbbRefreshVerify-icdb-recovery-20261027.zip 包含完整目录程序、试用说明、 本报告和逐文件 SHA-256 构建清单;压缩包旁另有 SHA-256 文件。源码构建提交为 9cd4968,版本号仍为 0.2.2b1,这是分支修复试用包,不是新正式版本。 解压整个目录后启动 CbbRefreshVerify.exe,必须保留 _internal。尚未部署到 200091-CBB,也未推送远端;现场已有共享库损坏仍受上述原生入口限制。