症状索引：从哪里入手

你手上只有症状，还没有诊断。找到与你看到的现象匹配的行，完成首要检查，再点开详细材料的链接。每一行都以诊断阶梯为基线：电平 → 清洁 → 更换 → OTDR。

链路状态

症状	首要检查	可能原因	阅读
端口不起来，模块显示 unsupported / invalid / Mod_Inv	主机日志、工作台上的身份信息	厂商锁定；主机拒绝的身份或合规代码	厂商锁定、无链路检查清单
端口不起来，两端 Rx 均为 −40 dBm / LOS	Tx 是否使能？光纤是否连通？	光纤断裂、主机禁用了 Tx、Tx/Rx 接反、BiDi 配对错误、波长与复用器不符	无链路检查清单、物理层不匹配
端口不起来，Rx、Tx 电平均正常	两端的 FEC 和速率；DAC 上的自动协商	FEC 不匹配、速率/拆分配置、SGMII 与 1000BASE-X 之争、CDR 速率不对	速率与模式问题、FEC 与链路训练
端口不起来，短距链路上 Rx 很高（> −3 dBm）	是否在短距链路上用了长距光模块？	接收机过载	物理层不匹配
单方向通、单端 LOS	对比两端 Rx	故障一侧连接器脏污或激光器偏弱；极性问题	DDM 电平、物理层不匹配
链路抖动、时断时续	电平、CRC 计数器、连接器	污染、余量临界、热限流	链路抖动
400G/800G 模块被识别却始终未就绪，卡在 LowPwr	CMIS 模块状态、功率等级与端口的匹配	握手/固件/功率等级问题	CMIS 问题、功率与散热
DAC 不通，同一端口换光模块就通	自动协商/链路训练、线缆长度、身份信息	自动协商被禁用、线缆不受支持、对主机而言过长	铜缆以太网与 DAC、速率与模式问题

链路通了，但……

症状	首要检查	可能原因	阅读
CRC / 输入错误持续上升	Rx 电平对比基线；FEC 纠正计数器；清洁情况	污染、余量临界、长距 CWDM 上 10G 及以上速率的色散	链路抖动、DDM 电平
多通道链路吞吐量变慢，无告警	每通道 Rx/偏置电流	一条退化的通道被 LACP 掩盖	失效、逐通道诊断
25G 能通，10G 不通（或 100G 正常，4×25G 拆分不行）	速率代码、CDR 旁路、主机拆分配置	CDR 范围、模块不支持拆分、缺少扩展合规代码	速率与模式问题、CDR
DDM 数值离谱（0 °C、+10 dBm、0.00 V）	字节 92 的校准位	未应用外部校准、常数被清零	校准
整批模块的 Tx 功率完全相同	对比多个模块	存储器中写入的是固定 Tx 值	DDM 电平
模块发热，端口将其禁用，日志显示“power exceeds”	功率等级字节与端口额定值；通风	等级不匹配、热关断	功率与散热
一年内一切正常，随后突然失效	Tx 偏置电流趋势、批次	激光器老化、坏批次、过热	失效
交换机固件升级后模块集体失效	主机发布说明；身份信息	身份校验更严格；克隆模块认证失败	厂商锁定、失效

在工作台上（编程器 / CodingBox）

症状	首要检查	可能原因	阅读
编程器未检测到模块	插接、封装形式转接器、上电时间	未插到位、适配座不对、模块处于 LowPwr	EEPROM 读写错误
读出 FFh / 00h 或乱码	地址（A0h/A2h/page）、总线速度	I²C NACK、页选错误、总线过快	EEPROM 读写错误
WRITE FAIL	密码、写保护类型、时钟速度	模块受保护、硬件写保护、时序问题	写保护类型、EEPROM 改码
写入“成功”但断电重启后回滚	模块类型	临时存储区需要保存命令	写保护类型
修改后主机拒绝模块	校验和	CC_BASE / CC_EXT / CC_DMI 过期	存储器映射

接入网

症状	首要检查	可能原因	阅读
ONU 在 OLT 上无法注册	序列号 / LOID、PON 标准、ONU Rx	白名单、波长方案错误（GPON 对 XGS-PON）、Rx 超出等级	PON 问题
ONU 显示 LOS	SC/APC 清洁度、分光器、端面研磨	脏污、在 APC 系统中用了 UPC、光纤问题	PON 问题

如果都不匹配

从头到尾过一遍无链路检查清单，再用 CodingBox 在工作台上读取模块：Check transceiver 界面告诉你模块声称自己是什么，DDM 告诉你它实际在做什么。

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