6.6 KiB
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,也未推送远端;现场已有共享库损坏仍受上述原生入口限制。