光模块链路不通怎么排查：端口、光纤、FEC 与光功率检查
按设备识别、端口模式、模块 PMD、MPO/LC 布线、光功率、FEC 与误码顺序排查光模块不亮、链路 flap、误码增长和分支端口异常。
Selection Comparison
光模块链路故障症状与优先检查项
| 故障症状 | 优先检查 | 常见原因方向 | 验证动作 | 结论边界 |
|---|---|---|---|---|
| 设备不识别模块 | 端口支持、模块信息、系统日志 | 封装或管理协议不支持、编码或版本不匹配 | 记录设备、板卡、系统版本与读取到的模块信息 | 不识别不能直接证明模块硬件损坏 |
| 模块已识别但链路不亮 | 速率、lane mode、FEC、对端 PMD | 端口模式、FEC 或两端光接口不一致 | 逐项核对双端配置，并固定其他变量复测 | 单次更换模块点亮不能定位唯一根因 |
| 链路反复 flap | 光功率趋势、温度、连接点、系统日志 | 接触、损耗余量、温升或端口训练不稳定 | 持续流量下保留时间序列与异常时日志 | 瞬时正常读数不能代表长期稳定 |
| FEC 或误码持续增长 | 纠错计数、不可纠错错误、光功率和布线 | 信号裕量不足、端面或布线问题、模式不匹配 | 比较清洁、替换跳线或端口前后的同条件结果 | 不能只凭一个累计计数判断模块责任 |
| breakout 部分支路不通 | 源端分支模式、线缆映射、各分支配置 | 源端未正确拆分、芯序或分支端速率/FEC 不一致 | 逐支路记录端口、映射、模块与错误计数 | 物理通道数量不等于主机必然支持分支 |
结论先行：先固定测试条件，再按层级缩小范围
光模块链路不通时，不应一开始就把问题归因于模块或兼容编码。先记录设备、板卡、系统版本、端口、模块、光纤、对端、FEC 和当前症状，再按主机端口、双端 PMD、布线、光功率、误码与温度逐层排查。每次只改变一个变量，才能判断变化与故障是否相关。
先区分不识别、不亮、flap、误码和分支异常
设备完全读不到模块信息、能够识别但链路不亮、链路反复 flap、业务已通但 FEC 或误码增长，以及 breakout 只有部分支路工作，是不同问题。开始操作前先保存端口状态、模块诊断、错误计数、光功率、温度和系统日志，避免重启或换件后丢失原始现场。
第一层检查主机端口、速率和 FEC
确认模块封装是否受目标端口支持，端口配置速率、lane mode、直连或 breakout 模式是否与模块和对端一致，并记录 FEC 的配置与实际状态。OSFP、QSFP-DD、QSFP28、SFP28 等外形或速率标签不能替代主机资料；同一个笼子也可能受板卡、ASIC 和系统版本限制。
第二层核对双端模块和光侧 PMD
两端速率相同并不代表可以互通。SR、DR、FR、LR、BiDi、CWDM、单波长和多波长方向可能使用不同光纤、波长、通道数量与 FEC。应记录两端完整型号、管理信息、波长或 PMD、温度和告警；BiDi 还要确认收发波长互补，不能使用两个同向型号直接连接。
第三层检查 MPO、LC、光纤类型和连接路径
MPO 链路需要核对芯序、极性、并行通道和分支映射，LC 链路需要核对 Tx/Rx 方向与双芯路径。多模、并行单模和双芯单模不能混用。排查时记录跳线、配线架、转接点、光纤等级和长度，并在受控条件下检查端面、减少中间连接或替换合格参考跳线。
光功率在范围内也不能单独证明链路正常
收发光功率必须结合具体 PMD 的发射窗口、接收灵敏度、接收过载、链路损耗和测量条件解释。接收功率看似正常但仍不通时，继续检查对端 PMD、FEC、通道一致性、端口训练和误码；长距模块用于低损耗短链路时还要排除接收过载。
FEC、误码和 flap 要看趋势而不是单点
持续增长的纠错计数、不可纠错错误、重训练和 flap 比一次零误码截图更有诊断价值。建议在固定流量、端口和温度条件下记录起止计数与时间，并比较清洁端面、替换跳线、换端口或换模块前后的同条件结果。累计计数没有清零或缺少时间基准时，不能直接归因。
形成可复现记录后再决定更换、返修或兼容调整
最终记录应包含设备与系统版本、端口模式、双端模块型号和编码、光纤与连接器、长度与连接点、FEC、收发光功率、误码、温度、告警、测试流量、持续时间和每次变量变化。只有故障能够随同一模块、端口、跳线或配置稳定迁移时，才具备进一步定位和交付处理的基础。