1. QKD链路异常排障总览：从告警到定位的闭环流程

告警触发后的第一反应：先建闭环，再动手

一条QKD链路报出“密钥生成率下降”时，最危险的做法是立刻去调激光器功率或重启协议栈。密钥生成率（SKR）是整条链路多个环节共同作用的结果，单点盲调往往把可复现的故障变成不可复现的故障。本例的任务是：把一次SKR下降告警，按“接收—分类—取证—定位—修复—回归”的闭环走完，并产出一份可复用的排障检查清单。

闭环的关键在于责任边界与证据交接：每个环节必须明确“我拿到什么、我产出什么、我交给谁”，否则排障会退化成多人反复询问同一批数据。下图给出本例采用的闭环结构，以及各环节的核心输入输出。

各环节的输入输出与责任边界

闭环能否跑通，取决于每个环节是否“只做自己该做的事”。下表把本例的边界固定下来，避免一线在证据不全时越权改配置，也避免专家在缺少基线时凭经验下结论。

初步分类的判断依据

分类不是猜，而是用少量高区分度指标把故障域缩小。本例采用三条快速判据，任一条成立即可给出初判标签，并决定证据采集的优先顺序：

• QBER是否同步升高：若SKR下降同时QBER明显高于基线，优先怀疑光学层（光功率、探测器、光纤扰动）；若QBER平稳而SKR下降，优先怀疑协议层或密钥管理层（纠错/隐私放大效率、密钥池消耗）。
• 是否伴随物理/环境告警：温度、风扇、供电、板卡在位告警出现时，物理层优先，因为环境异常会级联影响光学与协议表现。
• 是否近期有变更：近24小时内有配置变更、光纤割接、软件升级的，变更点优先核查，这是最高性价比的定位入口。

可复用的排障检查清单

下面这份清单可直接作为工单附件使用。字段设计围绕“证据是否足以支撑定位”展开，而不是罗列所有可能操作。

闭环中最容易断掉的两处

第一处是②到③的交接。初判标签若只写“疑似光学问题”，证据采集就会只盯光功率，而漏掉协议层日志。正确做法是标签后必须附一句“依据”，例如“QBER由1.8%升至4.2%，初判光学层”，这样采集人知道为什么采、也知道该顺带排除什么。

第二处是⑤回到③的回退。回归不通过时，常见错误是直接在④反复改配置。正确路径是退回③补采证据，因为不通过本身就说明此前的证据包不足以支撑根因结论。回退时必须写明“缺哪一层证据”，否则补采会再次变成盲目采集。

按上述闭环走完一次SKR下降告警，交付物应包含：一份带初判依据的工单、一个分层证据包、一条根因结论与对应修复动作、一份回归判定记录。这四件东西齐了，本次排障才算闭环；缺任何一件，都应在工单中标注为“未闭环”并说明缺口。