7.3 KiB
iCDB 旧服务器会话失联:分析、恢复步骤与分支改动
分支:codex/icdb-lost-session-diagnostics,基于 a11eb3c(v0.2.2-beta.1)。
错误的含义和影响范围
现场消息为:
The last server session on different server machine lost the connection
to the database. Please use iCDB Project Backup 'Repair project'
functionality to fix this issue.
Machine: [200091-CBB]
Session: [2026-10-24 08.22.29-10308]
原生 iCDB 检测到先前服务器会话的数据库状态需要检查/修复。这不是
“当前网络连接已经恢复就可以继续”的提示,也不能仅凭它认定端口被 Windows 保留。
Machine 和 Session 是故障记录中的原服务器、会话标识,不能当作当前进程 PID。
用户贴出的路径包含 5:\5ymbolLibsReusableBlockssymb,存在文字识别/转录歧义。
本机隔离样本确实存在 SymbolLibs\__ReusableBlocksSymb\icdb.dat:如果现场原文
指向这个结构,问题影响的是中心库共享符号数据库,而非单个 CBB 的
ReusableBlocksLP\<CBB>\Work\database。必须以现场原始日志为准,不能自动把
5: 改成 S:,或根据 CBB 名称推导修复目标。
异常关闭、原服务器/网络存储断开、写库期间复制工程、跨机器访问不一致的 路径,都可能涉及此类状态。现有消息不能区分这些原因,也不能证明 “校验失败一定导致损坏”;数据库异常本身同样会导致校验失败。共享符号库 出问题时,不同失败 CBB 可能只是访问了同一个有问题的数据库。
现场恢复步骤
- 停止批量校验,核对
200091-CBB和其他访问同一中心库的客户端。 正常关闭占用该目标的 Library Manager、PCB、原理图/符号编辑会话,并确认 原数据库服务器的实际状态;只看本机没有 PCB 或 TCP 探测失败不足以确认独占。 - 在会话正常关闭后保留完整、一致的工程/中心库副本。共享库问题需包括
.lmc、相关SymbolLibs数据库、原有ProjectBackup/数据库备份和日志。 工具日常的backup/排除了database等目录,网络操作还可能跳过备份, 因而不能把它当作这次修复所需的完整回滚副本。 - 使用现场相同 Mentor 版本的 iCDB Project Backup,先核对打开的工程或
备份存储确实关联报错数据库,再执行 Project → Repair(错误提示称为
Repair project)。如果目标是共享符号库,而工具无法识别对应库/存储, 应由库管理员按该版本支持的库恢复流程处理,不能改选无关的 Work PRJ。 - 保留原生工具的修复输出及
Project Repair备份,确认修复结果。 不通过删除sAddress.adr、锁文件、icdb.dat,也不通过强杀数据库服务器 来代替 Repair。如果原生修复失败,再依据原生日志选择一致备份恢复。 - 正常重新打开原先失败的目标,先复测一个 CBB,检查本轮原生日志、
Project Integration、Save/Close 和进程释放,再以
IsVerifiedReuseBlock返回READY/raw=1确认校验成功。之后再扩大批次。
本机已确认原生入口:
%SDD_HOME%\iCDB\win32\bin\iCDBProjectBackup.exe
只读检查其命令行帮助显示 -p <project file>、-ver、-h;菜单资源确认存在
Project → Repair。没有查到公开的直接 Repair 命令行开关,因此本分支没有
编造 -repair 参数,也没有自动投递写库修复命令。曾在本机既有隔离样本上
打开原生管理界面进行入口检查,未执行 Repair;本机没有用户本次故障库,
未在 200091-CBB 或现场网络库上执行恢复。
代码修复
- 在内容检查输出、实时弹窗和本轮
PCBLogFile.txt、ForwardAnnotation.txt、MsgBoxResponse.log、PartPkg.log中识别完整的服务器会话失联消息。 - 分类为
ICDB_REPAIR_REQUIRED,保留原始错误和Machine/Path/Session, 区分共享符号库、Work 工程数据库及不能确定的目标;写入diagnostics/icdb-recovery.json并在失败清单显示恢复说明。 - 该错误优先于通用打开失败、JobPrefs 错误及清理失败;即使内容检查同时
输出成功文字和退出码 0,也不能变成 PASS。标记
safe_to_continue=False, 后续条目标记 SKIPPED,沿用现有会话、证据、网络映射保留机制。 - 将当前日志与启动前检查点比较,支持追加、截断、等长/增长重写、UTF-16 及 UTF-8;恢复识别每次最多读取两个 128 KiB 片段。不能确认日志新旧时 保留原始失败,不据旧记录推荐本轮修复。重写后保留的同一历史会话不作为 新证据;可验证的追加则允许识别同一会话再次报错。
- 通用
Could not run server不再直接推断端口保留并提示重启 WinNAT。 启动前独立端口绑定探测保留原逻辑。
验证和边界
原分支基线:python -m pytest -q,383 项通过。
新增回归包括原错误、共享库身份、内容检查停止队列、多行集成日志、
日志重写及历史错误隔离、编码、证据写入失败和监督器失败摘要。
诊断修复阶段验证(后续生命周期修复见下方链接):
- 全量 Python 测试 417 项通过,含 34 项新增回归;仍有基线已有的 一条 pywinauto STA COM 模式提示。
- 两组 PowerShell 测试、
python -m compileall -q src tests、git diff --check通过。 - 只读解析仓库留存的真实 TUNER_R836_A 现场日志,正确提取到机器
EDA03、S:\ReusableBlocksLP\TUNER_R836_A\Work\database及会话2025-01-21 14.44.46-2323356。该记录仅用于解析验证,不代表本次现场故障。 - 独立代码复查发现的集成日志遗漏、通用端口建议覆盖具体原因、历史日志 重写误判、不可读/超出窗口的基线问题,均补充回归并通过复核。
本分支修复自动化的错误识别、误导性建议和失败后的继续执行风险, 现在还会在目标明确、会话完全释放且完整备份成功时,自动调用同版本原生 Project → Repair,并只在原生诊断、Project Repair 备份、目标数据库关闭等 证据全部满足时重试一次校验。共享符号库路径没有 PRJ 入口时会明确阻断, 不会猜测或改修某个 CBB 的 Work 数据库。
这次在新复制的 IP101GR 工程上完成了真实隔离验证:Repair 菜单确认、完整
备份、原生 dbcheck/数据库日志、Project Repair ZIP 校验和数据库关闭均
成功;Repair worker 退出码为 0,随后才允许重试。该验证没有接触生产库。
仍然没有修复现场受损数据库,也没有在 200091-CBB 上执行恢复。
恢复识别仅覆盖已知日志末尾的有限窗口;错误出现在窗口外、相同历史会话
在重写时被原样重报、超出基线窗口的大日志发生重写、以及现场不同日志位置/格式,
仍需结合完整原生日志确认。这些不能确认新旧的情况不会自动提升为本轮修复诊断。
用户后续确认事故版本为 r4 或更早。失败强杀根因、正常关闭修复、自动 Repair 范围和 448 项最终回归详见 失败生命周期与恢复验证。