华为H3C实战 | 第2章 接口基础配置

📚 本系列共 43 篇（第 2 / 43 篇）　·　第一卷 基础篇 —— 交换机的骨架

← 上一篇：第 1 章 命令行基础与设备管理 　下一篇：第 3 章 VLAN 与二层转发 →

本章导读：接口是全网唯一横跨物理层与数据链路层的部件，它 up 不 up、协商成什么速率双工，决定了上面所有协议能不能跑。现场见得最多的两类怪病——“接口 up 但不通”、“接口 down 但线是好的”——九成出在本章的基础参数上。

本章结构：

• 2.1 功能原理与业务场景 —— 接口命名规则（华为 0/0/x vs H3C 1/0/x）、接口类型速查表、combo 口"一鱼两吃但不能同用"
• 2.2 华为设备配置详解 —— 速率/双工/description/MTU、display interface 数 CRC 与 late collision、二层口转三层口（undo portswitch，有型号限制）
• 2.3 H3C 设备配置详解 —— port link-mode route/bridge 全系可用、combo enable 的写法
• 2.4 命令对照表 —— combo 口选择、二层转三层这两处差异最容易抄错
• 2.5 配置验证 —— PHY/Line protocol 两行怎么读、display transceiver diagnosis 看光功率
• 2.6 排错与故障树 —— 95% 的接口故障对照表（*down、能 ping 通但丢包、速率只到 100M、光口收发反接、error-down）+ 接口 down 故障树
• 2.7 新手踩坑 —— 一端强制一端自适应、combo 介质选错
• 2.8 本章小结 —— 要点清单 + 自测题

重点提示：接口 down 时先看有没有 * 前缀——*down 是本端 shutdown（一条 undo shutdown 就行），down 才是物理层问题。能 ping 通但很卡直接看 2.6 的"能 ping 通但丢包严重"行：清掉计数再观察 CRC/冲突数是否增长，基本锁定双工错配或线材。 关联章节：接口的 VLAN 归属（access/trunk/hybrid）见第 3 章；把接口变成三层口、配 IP 做网关见第 6 章；把多根线捆成一根看第 5 章。

2.1 功能原理与业务场景

2.1.1 这功能是干嘛的（通俗版）

把交换机想成一栋写字楼的「管道系统」：楼里每一间办公室（终端设备）都通过一根水管（网线/光纤）接到大楼的管路汇流井（交换机接口）。接口配置干的就是交代清楚这三件事——这根管子是多大口径的（速率与双工）、这根管子通向哪个房间（接口归属的 VLAN，第 3 章讲）、这根管子是给普通办公室供水的还是给消防系统共用的（二层口还是三层口）。

听着简单，但接口是全网唯一「既在物理层又在数据链路层」的设备部件，它的状态好坏直接决定了上面所有协议能不能跑。我在现场见过最多的不是协议配错，而是「接口 up 但不通」和「接口 down 但线是好的」——这两类问题九成都出在接口的基础参数上：速率不匹配、双工错配、combo 口选错、光模块型号不兼容、接口被 shutdown 了忘了 undo。

2.1.2 在网络里怎么落地（设计视角）

一台典型的华为 S5735-L24T4S-A1 接入交换机，接口编号的命名规则是「槽位号/子槽位号/端口号」，例如 GigabitEthernet0/0/1。对盒式设备来说，0/0 基本固定，只有最后一位变化；堆叠成 iStack 后，第一位的槽位号会变成堆叠成员编号（如 GigabitEthernet1/0/1 表示 1 号成员的第 1 个口）。H3C S5130S-28S-EI 是 GigabitEthernet1/0/1 这种格式，遵守「成员编号/槽位号/端口号」的约定，IRF 中成员编号会变成 2、3……

常见的接口类型有下面这些，看名字就知道是什么：

再说数据流。一个二层交换机的接口，收到一帧数据，做的事情顺序是：物理层收到电信号/光信号 → 解析以太网帧头 → 根据接口配置的 VLAN 属性（access/trunk/hybrid）决定给这一帧打不打 VLAN 标签 → 查 MAC 表决定从哪个口发出去 → 出口按出口的 VLAN 属性决定剥不剥标签。接口参数里速率和双工错配会直接打断第一步和第二步：速率不一致时链路根本 up 不起来，双工错配时链路能 up 但会有大量 CRC 错误和丢包，这是「能 ping 通但很卡」的经典原因。

而 combo 口（口语叫「复用口」）是很特殊的一类：一个物理位置，里面藏着一个电口和一个光口，两者共用一个接口编号，同一时间只能用其中一个。设计它的初衷是方便用户既可以用网线上联也可以用光纤上联，代价是不能同时用。很多机房出现「插了网线但没通、光模块亮着」的问题，就是 combo 口选错了介质。

        [光电复用的 combo 口]
        ┌──────────────┐
        │  电口 RJ45   │ ← 网线
        │  (copper)    │
        │     或       │  同一时刻只选一个
        │  光口 SFP    │ ← 光纤 + 光模块
        │  (fiber)     │
        └──────────────┘
               │
        内部同一个接口 GigabitEthernet0/0/25

适用版本：华为 VRP V200R019 及以上（S5735/S5700/S6700 等），H3C Comware V7（R2610 及以上）。Combo 口、二层三层切换、光模块诊断命令的支持与型号强相关，具体请以设备 display interface 输出与 ? 帮助为准。

2.2 华为设备配置详解

2.2.1 命令行基础速览（本章会用到的那几条）

2.2.2 完整配置模板

下面是一台接入交换机典型接口的完整配置：上联口做千兆固定速率 + 光模块自检，接入口做自适应 + 描述 + 关闭不使用口，另一个口切三层口做管理上联。

# 进入系统视图
system-view

# 上联口：光口固定 1000Mbps 全双工，写明对端是谁
interface GigabitEthernet0/0/24
 description TO-CORE-SW01-GE0/0/24
 speed 1000
 duplex full
 undo shutdown
 quit

# 千兆电口接入：自适应即可，加上描述便于排障
interface GigabitEthernet0/0/1
 description DESK-3F-01
 undo shutdown
 quit

# 不使用但已布线的接口：物理关闭，防止误接入
interface GigabitEthernet0/0/10
 description UNUSED-DO-NOT-USE
 shutdown
 quit

# 批量对一段接口同时加描述（部分版本支持 interface range）
interface range GigabitEthernet0/0/11 to GigabitEthernet0/0/20
 description DESK-3F-BULK
 shutdown
 quit

# 把某个物理口切成三层口并用它做管理上联
interface GigabitEthernet0/0/23
 description MGMT-UPLINK-L3
 undo portswitch
 ip address 10.200.99.11 255.255.255.0
 quit

# 打开光模块诊断监控（部分型号缺省即开）
interface GigabitEthernet0/0/24
 transceiver diagnosis enable
 quit

# 回到用户视图保存
quit
save

2.2.3 逐行讲解

先看 description。这条命令看似可有可无，实际上是运维效率的分水岭。一根网线在机柜里跟别人的线混在一起，你只有两个办法知道它通向哪：拔下来看标签（可能已经掉了），或者看设备里写的描述。行业规范是每个接口都要有描述，格式统一，例如 TO-CORE-SW01-GE0/0/24（到对端设备名 + 对端接口名）、DESK-3F-01（房间号）。有了统一格式，display interface description 一次就能把整台设备的接线关系导出来做成记录，交接时非常省事。

关于二层/三层切换，这里要讲透。华为交换机的物理口缺省是二层口（bridge 模式），即它是「一组 VLAN 的成员」，不能直接配 IP。要让物理口直接当三层口用（比如点到点接路由器），必须用 undo portswitch 切换。但这条命令仅部分产品支持，判断方法很简单：

# 看接口的 link-type，如果是 route 说明是三层口
<HUAWEI> display interface GigabitEthernet0/0/23
# 关注输出里的 "Port link-type: route" 或 "Port link-type: access"

还有两条官方给出的硬性约束，实际配置时必踩：① 接口下只能存在属性类配置（如 shutdown、description）时才能切模式，如果已经有 port link-type trunk 这类业务配置，必须先清干净再切；② 连续执行 portswitch / undo portswitch 切换二三层模式，两次之间至少间隔 30 秒，否则后一次不生效。另外只有「从二层切到三层」的接口才能用 portswitch 切回来，原生三层接口不支持切二层。

如果不支持 undo portswitch，那么物理口就只能当二层口，要做三层互联只能走 VLANIF（建一个 VLAN、把两个接口都划进去、在 VLANIF 上配 IP）。这不是「凑合」，很多接入型设备的设计就是这样，属于正常的产品能力差异。⚠ 版本差异：undo portswitch 在 S5700-EI/HI、S5731、S6730 等型号上支持较好，S5720-LI/SI 等入门型号上可能不支持，配置前务必在目标型号上实测。

关于 interface range，华为有两种写法。新版本支持 interface range：

# 新版本写法
[HUAWEI] interface range GigabitEthernet0/0/1 to GigabitEthernet0/0/8
[HUAWEI-port-group] description DESK-3F

老版本用法是 port-group：

# 老版本写法：先建端口组，再加成员
[HUAWEI] port-group PG1
[HUAWEI-port-group-PG1] group-member GigabitEthernet0/0/1 to GigabitEthernet0/0/8
[HUAWEI-port-group-PG1] description DESK-3F

⚠ 这两种写法在不同 VRP 版本上表现不一，interface range 在部分版本里提示符显示为 [HUAWEI-port-group]，操作方式与普通接口视图一致。建议在目标设备上用 interface range ? 确认。

关于速率与双工，有一条工程铁律：能自适应就自适应，两边都强制时必须强制成一样的。自适应（auto）的好处是协商能自动选择双方都支持的最高能力；坏处是极端情况下可能协商到次优结果（比如设备支持 1000M 但协商成 100M）。强制的好处是确定性；坏处是一端强制、一端自适应会导致协商失败——千兆链路的自协商机制里包含速率和双工两个部分，一旦一端禁用自协商，另一端会退化到最低能力甚至直接 down。这类问题的典型表现是：

H3C 的对应配置结构完全一样，关键差异在二层/三层切换命令上：H3C 用 port link-mode route / port link-mode bridge，这是 Comware V7 里所有型号都支持的写法，比华为的 undo portswitch 一致性更好。

物理层与数据链路层的分工

理解接口，最省事的办法是把「物理层」和「数据链路层」分清楚，因为排障时你永远要先问自己：问题出在哪一层？

物理层（Layer 1） 关心的是「电信号/光信号能不能传过去」。相关的参数有：介质类型（双绞线/光纤）、速率、双工、编码方式、光功率。物理层正常的表现就是接口状态 PHY: up。物理层的问题只能靠换线、换模块、换端口、清洁端面来解决——在物理层出问题时，任何配置都救不回来。

数据链路层（Layer 2） 关心的是「帧能不能正确收发」。相关的参数有：VLAN 归属、MAC 地址学习、MTU、双工协商后的冲突域行为。数据链路层正常的表现是 Line protocol: up 且 MAC 表能学到对端。数据链路层的问题才靠配置解决。

接口状态里的 PHY 和 Protocol 两列，正好对应这两层：

up / down 这一格是最容易误判的：物理层「亮着灯」但链路层不通，很多人第一反应是线有问题，于是换了三根线还是不通。实际上这类故障多半在数据链路层——最典型的例子是链路聚合两端工作模式不一致（一端配置成 LACP 主动、另一端是手工模式），成员口的物理层是 up 的，但因为协商信息对不上，聚合组不选中它，业务就是不通。第 5 章会详细讲这个场景。

接口的命名与编号规律

看懂接口编号，才能在机柜前找到对的那根线。两家的编号规则本质相同，都是「成员号 / 槽位号 / 端口号」，但起始值不同：

这里要特别提醒：H3C 的堆叠成员编号和华为的写法在视觉上会重叠，华为堆叠后 GigabitEthernet1/0/1 指的是「1 号成员第 1 口」，而 H3C 单机上 GigabitEthernet1/0/1 指的是「1 号成员（就是本机）第 1 口」。所以看别人写的配置时，一定要先确认这是华为还是 H3C 的编号体系，否则「1/0/1」在不同体系里含义完全不同。这也是本书严格区分提示符 [HUAWEI] 和 [H3C] 的原因。

接口描述规范与拓扑文档

接口描述不是装饰，它是「设备里自带的一份拓扑图」。工程上建议用固定格式，让描述本身携带结构化信息：

格式1：TO-<对端设备名>-<对端接口名>
  例：TO-CORE-SW01-XGE0/0/2
格式2：<建筑>-<楼层>-<房间>-<序号>
  例：DESK-B1-F3-301-02
格式3：<业务类型>-<用途>
  例：AP-B1-F3-CORRIDOR / CAM-1F-GATE / SRV-RACK-A-U12

好处是：display interface description 一条命令就能导出全网的接线关系；用 include 过滤能快速找到所有接 AP 的口（display interface description | include AP）。这在「核心交换机要清点下挂了多少 AP」这类需求上是神器。

PoE 供电接口的基础认知

接入交换机接 AP、接摄像头时，最常遇到的是 PoE（Power over Ethernet，以太网供电）。PoE 让一根网线同时传数据和供电，省去了给每个 AP 拉电源插座。华为与 H3C 的 PoE 交换机接口上有几个关键概念必须知道：

• 供电标准：802.3af（最大 15.4W，实际到设备约 12.95W）、802.3at（最大 30W，实际约 25.5W）、802.3bt（最大 60W/90W）。AP 用 af 还是 at，必须和交换机口能力匹配。
• 供电优先级：交换机的总功率是有限的（比如整机 500W），当接入的受电设备超过预算时，会按优先级断开低优先级设备的供电。默认低优先级是 0，可以通过命令调整。
• 供电状态查看：见下面这张已核实的命令表。

华为 PoE 的常用查看命令（以 CloudEngine S5700/S6700 配置指南-系统管理为准）：

配置侧常用的两条：poe power port-max-power（限制接口最大对外输出功率）、poe power-reserved power-reserved（配置预留功率占比）。供电延迟可用 poe power-on delay delay-time，下电时间段用 poe power-off time-range time-name。

PoE 排障的典型现象是「AP 时不时重启」：这不是 AP 的软件问题，而是交换机整机功率预算不足，受电设备超限被断开又重连。标准排查顺序是：display poe-power 看可用功率与预留比例 → display poe power 看各口实际取电 → display poe power-state 看供电状态与优先级 → 确认预算是否已被吃满。若确为预算不足，扩容 PoE 电源模块，或用 poe power port-max-power 收紧单口功率、规划供电优先级，把高优先级留给关键 AP。

⚠ 版本/型号差异：PoE 命令集与输出字段在不同型号上会有出入，H3C 侧更是完全另一套命令名（H3C 用 display poe 系列但参数不同）。上表以华为 S5700/S6700 V600R023C00 为准，别的型号请用 ? 确认。

接口形态的完整图景

把本章提到的所有接口形态串起来看，一台三层交换机的「接口武器库」是这样的：

这份表格在第 3、5、6 章会反复用到，现在混个脸熟就行，每章会展开讲其中一两个。

2.3 H3C 设备配置详解

2.3.1 命令行基础速览

H3C 的接口命名是 GigabitEthernet1/0/1（成员号/槽位号/端口号），display interface brief 的列格式与华为略有不同（H3C 输出 Link: ADM — 10M(a) F(a) A 这种组合，其中 A 表示 auto）。

2.3.2 完整配置模板

H3C 侧的接口配置与华为结构一致，关键差异在二层/三层切换（port link-mode）与 Combo 口选择上：

# 进入系统视图
system-view

# 上联光口：固定速率双工 + 描述
interface GigabitEthernet1/0/24
 description TO-CORE-SW01-GE1/0/24
 speed 1000
 duplex full
 undo shutdown
 quit

# 接入电口：自适应 + 描述
interface GigabitEthernet1/0/1
 description DESK-3F-01
 undo shutdown
 quit

# 不使用接口批量关闭（V7 支持 interface range 语法）
interface range GigabitEthernet1/0/10 to GigabitEthernet1/0/20
 description UNUSED-DO-NOT-USE
 shutdown
 quit

# 物理口切三层并配管理地址（H3C 全系支持，比华为更统一）
interface GigabitEthernet1/0/23
 description MGMT-UPLINK-L3
 port link-mode route
 ip address 10.200.99.11 255.255.255.0
 undo shutdown
 quit

# Combo 口指定使用电口（缺省一般是 auto，插哪个用哪个）
interface GigabitEthernet1/0/25
 combo enable copper
 quit

# 保存
quit
save force

2.3.3 逐行讲解

port link-mode route 是 H3C 最值得称赞的一处设计：不区分型号，所有 Comware V7 交换机都支持，把二层口切成三层口只需要一条命令，切回来用 port link-mode bridge。缺点与华为一样：切模式会导致该口下之前配的二层属性（VLAN 成员关系、端口安全等）全部失效，因此切之前要确认这个口没有业务，切完要重新配三层参数和 undo shutdown。实际工作中，切换会自动把接口 shutdown 掉，这是设备在保护你——切完记得手动 undo shutdown，忘了就会得到「配置都对但不通」。

⚠ 版本差异：Combo 口的选择命令在不同 Comware 版本和型号上有多种写法：combo enable { copper | fiber }（V5 常见）、port combo { copper | fiber }（部分 V7 型号），还有部分型号是自动识别、无需配置。请先用 display interface 看该口是否是 combo 口，再用 ? 确认命令。不确定时一律用自动识别，不要手工指定。

光模块与光纤的现场常识

光口排障之所以难，是因为它「看不见」。下面这些现场常识能省下大量返工。

光纤类型必须成套。多模光纤用短波长（850nm，模块类型 SX），单模光纤用长波长（1310nm，LX；1550nm，ZX），两者的模块不能混用，光纤也不能混接。多模用橙色或水蓝色外皮（OM3/OM4 是水蓝），单模用黄色外皮。接错的结果是「一头亮一头不亮」，RX Power 上就能看出来。

收发必须交叉。光纤有 TX（发送）和 RX（接收）两个芯，A 设备的 TX 要接 B 设备的 RX。做成了直联（TX 对 TX），两端接口都 down、两端 RX 都显示无光。绝大多数双芯光模块都是这个规律；单纤双向（BIDI）模块例外，它用一根纤同时收发，但配对必须是「1310/1550 的 A 端」对「1550/1310 的 B 端」，两端类型必须反着买。这是新手买模块最容易买错的地方。

光功率有预算这道数学题。收光功率 = 发光功率 − 链路损耗。一段光纤的损耗大约是每公里单模 0.35dB，每个熔接点 0.1dB，每个连接器 0.5dB，再加上现场弯曲、脏污带来的额外损耗。如果算下来收光功率低于模块接收灵敏度（千兆 LX 模块一般在 -20dBm 左右），链路就不稳定。排障时一定算一遍这个账，而不是盲目换模块。

端面清洁是被严重低估的故障源。光纤端面沾一粒灰，光功率能掉好几个 dB。规范做法是：插拔前用无水乙醇 + 专用擦纤纸（或一次性清洁笔）擦，不用手摸端面，不插纤时戴防尘帽。现场「一插就好了，过一个月又不行了」的循环，八成是端面污染。

两端速率与波长必须一致。千兆 SX 连千兆 LX 不能通；万兆 SR 连万兆 LR 也不能通。另外还有一类坑：百兆光模块配千兆光口可能不识别（部分型号支持自协商到百兆，部分不支持），买模块时要确认和交换机的兼容性列表。

接口 MTU 与巨型帧

接口配置里还有一个容易被忽略的参数：最大传输单元（Maximum Transmission Unit，MTU）。以太网缺省 MTU 是 1500 字节，超过这个长度的 IP 报文会被分片。而在某些场景下（存储网络、iSCSI、VDI 桌面、大文件传输），我们希望减少分片、提高转发效率，于是开启了「巨型帧（Jumbo Frame）」，把 MTU 放大到 9000 字节左右。

要点有三条：

• 巨型帧必须是全路径一致。链路上任何一台设备、任何一台服务器网卡，只要有一个环节只支持 1500，巨型帧就没意义，反而可能因为对端不分片而丢包。
• 巨型帧和 IP MTU 是两件事。设备侧的 jumbo-frame 影响的是交换机内部能处理的帧长度，主机侧的 MTU 是主机发出的 IP 包大小。两端要分别配。
• 很多接入交换机不支持巨型帧。入门型号可能固定 1518 或 9216 且不可配，配置前必须查型号规格。

# 华为：开启巨型帧（部分型号支持，值单位字节）
[HUAWEI] interface GigabitEthernet0/0/1
[HUAWEI-GigabitEthernet0/0/1] jumbo-frame 9216

H3C 开启巨型帧的等效配置如下：

# H3C：开启巨型帧
[H3C] interface GigabitEthernet1/0/1
[H3C-GigabitEthernet1/0/1] jumboframe enable 9216

⚠ 版本差异：华为部分型号的巨型帧是全局命令 jumbo-frame 9216（系统视图），部分型号是接口视图命令；H3C 部分型号是 jumboframe enable 不带数值（固定 9216），部分带数值。请以 ? 为准。

H3C 老设备（V5）的接口差异提示

对于老设备，还有一个常见陷阱：Comware V5 是 interface GigabitEthernet1/0/1 + port link-mode 也支持，但三层口命令是 port link-mode route 之外的另一种方式；具体差异请以 V5 手册为准，生产上遇到 V5 设备建议先统一升级或查阅对应型号手册。

2.4 华为 / H3C 命令对照表

H3C 侧已核实：Combo 口配置命令是 combo enable { auto | copper | fiber }，缺省为 auto（根据插入的介质自动识别并激活对应物理接口）。判断当前激活的是电口还是光口，看 display interface 输出里有没有 Media type is twisted pair 这一句——有就是电口激活，没有就是光口激活。

华为侧要注意产品线差异：combo-port { auto | copper | fiber } 是路由器（AR 系列）上的 Combo 接口命令；交换机的 Combo 口在不同型号上行为不同，很多型号是自动识别、根本不需要手工选，也有型号用 display interface 里的 Media type 字段反映当前介质。所以不要拿路由器手册里的 combo-port 去交换机上敲，先在交换机上 display interface <接口> 看当前激活介质，再决定是否需要配置。

⚠ 版本差异：Combo 口的强制选择能力与型号强相关，部分型号只支持自动识别、不提供强制切换命令。配之前先 display interface 确认现状，比盲目敲命令靠谱。

2.5 配置验证

接口配置的验证逻辑是「三层」的：先看物理层有没有 up，再看数据链路层有没有错包，最后看业务层通不通。这个顺序不能反，反了会浪费大量时间。

第一层：物理层。看接口是不是 UP，速率双工是多少：

<HUAWEI> display interface brief

正常输出（节选）：

Interface            PHY     Protocol InUti OutUti   inErrors  outErrors
GigabitEthernet0/0/1 up      up        0.01%  0.02%         0          0
GigabitEthernet0/0/24 up     up       12.31%  8.77%         0          0
GigabitEthernet0/0/10 *down  down         0%     0%          0          0

判断要点：PHY 列 up 说明物理链路通；*down 表示接口被 shutdown（星号是管理性关闭的标志）；down 无星号表示物理层没通（线没插、光模块坏、对端关着）。

<HUAWEI> display interface GigabitEthernet0/0/1

这个命令的输出信息量大，重点看这几行：

GigabitEthernet0/0/1 current state : UP
Line protocol current state : UP
Description : DESK-3F-01
Switch Port, PVID : 10, TPID : 8100(Hex)
...
Speed : 1000, Duplex : FULL, Negotiation : ENABLE
...
Input bandwidth utilization  : 0.01%
Output bandwidth utilization : 0.02%

Speed 与 Duplex 是否符合设计、Negotiation 是 ENABLE 还是 DISABLE，这两项决定了链路的稳定性。如果你看到 Speed : 100, Duplex : HALF 但设计是千兆全双工，那大概率是网线只做了 4 芯或者线材质量差。

第二层：数据链路层。看错包计数，这些计数器是判断「能通但质量差」的关键：

<HUAWEI> display interface GigabitEthernet0/0/24

重点看这几项计数的增量：

正确的判断方法是先清计数再观察：

# 清空统计，等 5 分钟后再看
<HUAWEI> reset counters interface GigabitEthernet0/0/24

清完后过几分钟再 display interface 一次，看这几项是否增长。持续增长就必然是物理层或双工问题，不是配置问题。

第三层：业务层。ping 对端地址、display arp 看有没有学到对端、display mac-address 看 MAC 有没有学到。这三样是「接口 up 但业务不通」的排查起点。

光模块自检是接入侧排障里最重要的一环。光纤断了、光模块坏了、两端波长不匹配，现象都长得一样（接口 down），必须靠光模块信息区分。工程上把它总结成「三看一问」：看类型与波长、看收光功率、看告警段，问一句「上次拔插是什么时候」。这个流程能在一分钟内把「模块坏 / 纤断 / 配置错」三种可能分开。

<HUAWEI> display transceiver interface GigabitEthernet0/0/24 verbose

正常输出（节选）：

GigabitEthernet0/0/24 transceiver information:
-------------------------------------------------------------
Common information:
  Transceiver Type              :1000_BASE_LX_SFP
  Connector Type                :LC
  Wavelength(nm)                :1310
  Transfer Distance(m)          :10000(9um),550(50um),270(62.5um)
  Digital Diagnostic Monitoring :YES
  Vendor Name                   :HUAWEI
  Vendor Part Number            :02310xxx
Manufacture information:
  Manu. Serial Number           :xxxxxxxx
  Manufacturing Date            :2023-05-10
Alarm information:
  Temperature high threshold(°C)  :85
  ...
Diagnostic information:
  Temperature(°C)               :36.00
  Voltage(V)                    :3.29
  Bias Current(mA)              :6.12
  RX Power(dBM)                 :-6.25
  TX Power(dBM)                 :-5.80

关键看三组数据。第一是 Transceiver Type 与 Wavelength：两端必须是同一种类型（1000_BASE_LX_SFP 对 1000_BASE_LX_SFP，1310nm 对 1310nm），一端 LX 一端 SX（850nm）绝对不能通（多模只能用短距 SX 或者配 O/E 转换）。第二是 RX Power 的数值：典型千兆 SFP 的接收灵敏度约 -20dBm 到 -24dBm 的告警线，正常值应该在 -3dBm 到 -15dBm 之间；如果显示 -40.00 或 LOW，基本等同于「没有收到光」——拔纤自环测试（TX 接到同一模块 RX）能不能看到 -5dBm 左右，能说明模块是好的，问题在链路。第三是 告警字段：如果有 Temperature high alarm、RX power low alarm 这类行，说明模块已经在越界状态。

# 只看诊断值，输出更短
<HUAWEI> display transceiver diagnosis interface GigabitEthernet0/0/24

H3C 的等价命令：

<H3C> display transceiver interface GigabitEthernet1/0/24 verbose
<H3C> display transceiver diagnosis interface GigabitEthernet1/0/24
<H3C> display transceiver alarm interface GigabitEthernet1/0/24

⚠ 版本差异：display transceiver alarm 命令在部分型号上不可用，如果提示命令不存在，改用 verbose 输出中的 Alarm information 段判断。

2.6 排错与故障树

接口排错的核心是「分清是哪一层出的问题」。下面这张表覆盖了实际运维中 95% 的接口故障：

再给一棵故障树，按「接口 down」这件事往下分：

接口 down
 |
 +-- 有 * 号（*down / Administratively down）
 |     -> 被 shutdown 了 -> undo shutdown
 |
 +-- 无 * 号（物理 down）
       |
       +-- 电口
       |    +-- 网线/水晶头？换线试
       |    +-- 对端交换机口 shutdown？display interface 看对端
       |    +-- 对端速率强制不匹配？两端统一
       |
       +-- 光口
            +-- 光模块插反（RX/TX 对调）？拔下来换个方向
            +-- 两端模块类型不一致？LX vs SX 不能通
            +-- RX 功率 -40 / LOW？拔纤自环判断模块好坏
            +-- 光模块不兼容（华为/H3C 原厂与非原厂）？设备日志会报 unsupported

关于「非原厂光模块」，这是华为/H3C 设备上一个真实存在的坑：设备会检测光模块的厂商信息，非认证模块可能被判定为 unsupported，导致接口不 up 或只工作不自量。设备日志里会出现 Optical module is not certified 或类似告警，display transceiver interface verbose 里 Vendor Name 显示为第三方厂商。处置办法：换原厂模块，或者在确认风险后接受（部分型号允许非认证模块工作，部分直接禁用）。不要在生产环境用来源不明的光模块，出问题时排障成本远超省下的钱。

2.7 新手踩坑与注意事项

1. 只配速率不配双工——症状：强制 speed 1000 后链路 up 但丢包；怎么避：速率和双工要么都 auto，要么都强制成匹配的一对。
2. 一端强制一端自适应——症状：链路反复 up/down 或协商到半双工；怎么避：两端必须同策略，最好都保持 auto。
3. shutdown 后忘了 undo shutdown——症状：配置全对但口不通，display interface brief 显示 *down；怎么避：改配置后固定动作是 undo shutdown 并验证。
4. undo portswitch 不被支持却硬配——症状：命令报错或提示不支持；怎么避：先 display interface 看 Port link-type，不支持就走 VLANIF 方案。
5. 切三层模式后没重开接口——症状：H3C port link-mode route 后接口自动 shutdown，配完不通；怎么避：切换后立即 undo shutdown。
6. Combo 口两种介质同时想用——症状：插了网线不通，以为口坏了；怎么避：清楚 combo 口同一时刻只能用一种，display interface 的 Media type 一看便知。
7. 接口描述随便写或不写——症状：半年后不知道哪根线通哪；怎么避：统一格式 TO-对端设备-对端口 / 房间号-序号，display interface description 可导出。
8. 光模块跨厂商混用——症状：接口 up 不了或日志报 unsupported；怎么避：同厂商同型号配套，缺失时用同规格第三方并做好记录。
9. 光口拔纤不戴防尘帽——症状：端面污染后 RX 功率逐月下降；怎么避：不插光纤时戴帽，插拔前用无水酒精 + 擦纤纸清洁端面。
10. 清计数前不记录——症状：把长期累积的错包当成新故障；怎么避：先 display interface 记下当前值，再 reset counters，几分钟后再看。
11. jumbo-frame 以为就是改 MTU——症状：配了 jumbo 但一堆小包问题没解决；怎么避：大帧只影响大帧转发能力，不改变 IP MTU 协商，跨设备要两端都开。

2.8 本章小结

接口是网络的「物理地基」，本章的核心可以浓缩成四条：

• 接口状态分三层看：物理层（PHY up/down、光模块）、数据链路层（错包计数）、业务层（VLAN/ARP/路由），顺序不能反。
• 速率双工的铁律：能 auto 就 auto；强制时两端必须一致；late collision 增长就是双工错配的铁证。
• 二层三层切换：华为 undo portswitch（有型号限制），H3C port link-mode route（全系支持）；切换后接口会被 shutdown，记得手动开。
• 光模块排障三看：看类型与波长是否匹配、看 RX Power 是否为 -40/LOW、看告警段是否有越界。拔纤自环是判断模块好坏最快的办法。

自测题

1. display interface brief 里 PHY 列显示 *down 和显示 down，含义有什么不同？
2. 一条千兆链路 display interface 显示 Speed : 100, Duplex : FULL，最可能是什么原因？怎么确认？
3. 华为设备上要给物理口直接配 IP 地址，需要先执行什么命令？如果该命令不被支持，替代方案是什么？
4. 光口 display transceiver diagnosis interface 显示 RX Power : -40.00，你怎么判断是模块坏还是光纤断？
5. display interface 里 late collision 计数持续增长，最可能是哪类配置问题？

1. *down 是管理性关闭（被人为 shutdown），物理层本身可能正常；down 无星号是物理层没通（链路未建立），需要检查线缆、光模块、对端。前者一条 undo shutdown 就好，后者是物理故障。
2. 大概率是网线只做了 4 芯（百兆只需要 1、2、3、6 四根线），或者水晶头接触不良、线材质量差导致无法协商到千兆。确认方法：换一根六类全芯网线重测；同时用 display interface 看 Negotiation 是 ENABLE 还是 DISABLE，如果两端都 auto 但还是 100M，基本就是线的问题。
3. 华为需要先 undo portswitch 把二层口切成三层口，然后才能 ip address。如果型号不支持 undo portswitch，替代方案是走 VLANIF：创建 VLAN、把该物理口划入该 VLAN（port link-type access + port default vlan）、在 interface Vlanif N 上配 IP。
4. 用「拔纤自环」法：把该模块的 TX 直接插回自己的 RX（用一根短纤或环回器），如果 RX Power 恢复到正常值（如 -5dBm 左右），说明模块是好的、问题在光纤链路（断纤、熔接点损耗、对端没发光）；如果自环后 RX 仍然是 -40dBm，说明模块的接收端坏了。注意有的模块 TX 功率也可能异常，此时 TX Power 会显示 N/A 或异常低值。
5. 最常见是双工错配：一端配置了全双工，另一端配置了半双工（或一端强制、一端自适应），半双工侧在检测到冲突后仍发送数据就会产生晚冲突。处置是两端统一成全双工或都改 auto。

关于本书：《华为 / H3C 网络设备典型功能配置详解》—— 面向国内高校/企业网络环境， 华为 VRP 与 H3C Comware 双厂商并排配置的实操教材，共 43 章。 全书所有命令尽量有官方出处，查不到的显式标注「待核实」。 返回系列目录