问题分类与诊断方法

本节梳理网络工程师在使用 SFP/QSFP/QSFP-DD 光模块和光纤布线时真正遇到的困难——取材于对 50 多个讨论帖和技术资料的行业调研——以及行之有效的解决办法。下面每个主题都有独立的材料，包含症状、原因和可行的解决方案。如果只有症状、不知从何入手，打开症状索引。

最常出问题的地方

问题领域	出现频率	材料
厂商锁定——«unsupported transceiver»、errdisable、端口不起来	非常常见	厂商锁定
第三方光模块——可靠性、坏批次、与厂商支持打交道	非常常见	第三方光模块
DDM/DOM——读取 Tx/Rx 电平、阈值、“在范围内却丢包”	常见	DDM 电平
链路抖动、CRC/接收错误上升、连接器脏污	常见	链路抖动
EEPROM 改码——密码、地址、编码工具	常见	EEPROM 改码
DAC 与 AOC 与光模块——100G/400G 线缆故障、弯曲半径	偶发	DAC 与 AOC
失效——激光器退化、过热、批次性损坏、假货	偶发	失效
CMIS 模块（QSFP-DD/OSFP，400G 及以上）——状态机、低功耗锁定、FEC	呈上升趋势	CMIS 问题

诊断阶梯

无论症状是什么，经验丰富的运维人员都遵循同一个顺序。它对 1G SFP 和 400G CMIS 模块同样适用：

读取两端的电平。 将 Tx/Rx 与安装时记录的数值对比，留意两个方向之间的不对称，以及是否越过 DDM 阈值。
检查并清洁连接器。 检查 → 清洁 → 复查。污染是你能挽回的最便宜的分贝。
重新插拔或更换模块。 重新插入光模块；如果无效，换成已知良好的模块。
双向 OTDR 测试。 只有到这一步，才应该怀疑光纤链路本身——并向服务商索要曲线。

只有完成这四步之后，深入研究 EEPROM 内容、CMIS 状态、FEC 设置或误码率才有意义。

贯穿始终的六个规律

留一个原厂模块用于支持电话。 业内被反复提及的建议：在向厂商开工单之前先换上原厂模块，这样支持人员就无法把责任推给第三方光模块。
EEPROM 编码解决了大多数“兼容性”问题。 兼容性关乎模块存储器中的识别字符串，而不是固件。这正是 CodingBox 存在的意义。
DDM 是主要工具，但并不完备。 阈值由模块厂商设定，廉价模块的 Tx 读数可能是虚构的，“在范围内”不等于“健康”。
链路三步法。 电平 → 清洁 → 更换模块 → OTDR。
从 DAC/AOC 转向光模块的趋势。 成熟的网络正在转向光模块 + 单模光纤，即使是短距离链路，也是为了可维护性和可升级性。
失效关乎批次和温度，而不是品牌。 四通道模块中单通道 Rx 退化是典型的隐性故障。

CodingBox 的用武之地

这些问题大多都归结到模块存储器——交换机无法识别的身份字符串、掩盖临界链路的阈值、守护受保护页面的密码。CodingBox 在 Check transceiver 和 DDM 界面中正是读取这部分存储器，并在 EEPROM editor 中修改它，自动重新计算校验和，并在 code database 中保留备份。

分步指南

症状索引——找到你的症状，获取首要检查项和对应材料。
无链路：检查清单——针对起不来的端口的十个有序步骤。
物理层不匹配——光纤类型、波长/ BiDi、APC/UPC、MPO 极性、Tx/Rx 接反、过载。
速率与模式问题——多速率、拆分、FEC、 SGMII 与 1000BASE-X、“type not supported”。
功率等级、低功耗与过热——功率等级字节、LowPwr、热告警。
EEPROM 读写错误——工作台一侧：未被检测到、读出 FFh、WRITE FAIL、写入回滚、校验和。
PON 问题——ONU 注册、LOS、电平、光棒。

如果您发现本资料中有不准确之处或错误，请选中相应片段并按 Ctrl+Enter，即可。