current state : DOWN não diz nada sobre o motivo. Pode ser um desligamento humano, uma falha de hardware, um cabo ou fibra ruins, um óptico incompatível, ou a sala onde o switch está — seis causas raiz diferentes, cada uma com sua própria verificação e sua própria solução. Esta é a ordem que as separa rápido, com os comandos display exatos e números reais de potência óptica.
By Yuwen Zhang (Atlas), founder of AtlasCommTech — 13 years of carrier & enterprise network deployments · Updated July 2026
A tentação é recorrer à mesma solução toda vez — reconectar o cabo, trocar o módulo. Isso funciona com frequência suficiente para ser perigoso, porque também esconde qual das seis causas estava realmente em jogo.
Uma interface Ethernet permanece Up sob a condição mais básica que um switch precisa cumprir: poder enviar e receber quadros. Quando não consegue, a luz indicadora apaga, current state mostra DOWN, e uma entrada de log como linkDown_active dispara. A partir daí, as causas possíveis se dividem claramente em seis ramos — alguém a desligou ou disparou um mecanismo de proteção, o próprio hardware do dispositivo falhou, o cabo ou a fibra em si está com defeito, o óptico e a fibra com que está emparelhado não combinam, o método de conexão estava errado, ou o ambiente ao redor do equipamento é o problema. Cada ramo tem seu próprio comando de diagnóstico, e adivinhar qual se aplica desperdiça exatamente o tipo de tempo que esta nota pretende economizar.
A seguir está a verificação para cada um dos seis ramos com os comandos exatos a executar, quatro casos de campo reais extraídos de registros de manutenção reais, e as respostas de perguntas frequentes que surgem sempre que uma porta se recusa a subir.
Comece com display interface e deixe o campo current state e qualquer motivo de ERROR DOWN levá-lo para o ramo certo — não um palpite.
Os rótulos do diagrama permanecem em inglês para clareza técnica.
Na prática, os ramos 3 (meio), 4 (uso) e 6 (o próprio óptico) se sobrepõem bastante — uma leitura de potência óptica fora do limite pode significar uma fibra ruim, um módulo incompatível, ou um transceptor falhando, e display interface transceiver verbose é o comando que ajuda a distingui-los. É por isso que a verificação óptica recebe seu próprio passo a passo detalhado abaixo.
Cinco verificações, cinco comandos diferentes — e a tabela de motivos de ERROR DOWN que evita que você adivinhe no ramo 1.
Se current state mostrar Administratively down, alguém (ou algo) mandou a porta parar — a questão é quem, e undo shutdown pode nem ser a resposta certa.
<HUAWEI> display logbuffer | include DOWN
Sep 19 2022 08:51:53 HUAWEI %%01IFNET/2/linkDown_active(l):CID=0x807a0427-
alarmID=0x08520003;The interface status changes. (ifName=10GE1/0/1, AdminStatus=UP,
OperStatus=DOWN, Reason=Interface physical link is down, mainIfname=10GE1/0/1)
<HUAWEI> display interface 10GE 1/0/1
10GE1/0/1 current state : DOWN (ifindex: 11)
Line protocol current state : DOWN
[HUAWEI-diagnose] display system internal device port 10ge1/0/1
Port enable related check:
--------------------------------------------------------------------------------
DevType AttrName AttrValue ExpectValue IsPass
--------------------------------------------------------------------------------
port isshut 0x1 == 1 YES
port portlfeisup 0x1 == 1 YES
port triggerShut 0x1 == 1 YES
port phyportisshut 0x1 == 1 YES
--------------------------------------------------------------------------------
// any row where IsPass is not YES tells you exactly why the port won't come Up
[HUAWEI] interface 10ge1/0/1
[HUAWEI-10GE1/0/1] error-down auto-recovery cause link-flap interval 300
Se é um lote de portas ou apenas uma indica se deve suspeitar da placa ou apenas daquela porta.
<HUAWEI> display interface brief
Interface PHY Protocol InUti OutUti inErrors outErrors
10GE1/0/1 up down 0.01% 0.01% 0 0
10GE1/0/3 down down 0% 0% 0 0
<HUAWEI> system-view
[HUAWEI] interface 10ge1/0/1
[HUAWEI-10GE1/0/1] loopback internal
Info: Ensure that the port is not in default VLAN 1 to prevent traffic loops.
[HUAWEI-10GE1/0/1] display this interface
10GE1/0/1 current state : UP (ifindex: 23)
// came UP under internal loopback -- no hardware fault, problem is external
O cobre e a fibra falham de formas diferentes e precisam de ferramentas diferentes — virtual-cable-test para um, limites de potência óptica para o outro.
<HUAWEI> system-view
[HUAWEI] interface 10ge1/0/1
[HUAWEI-10GE1/0/1] virtual-cable-test
Warning: The command will stop service for a while, Continue?[Y/N] y
Pair A state: Ok
Pair B state: Ok
Pair C state: Ok
Pair D state: Ok
// any pair reporting Open or Short instead of Ok -> replace the cable
<HUAWEI> display interface 10ge1/0/2 transceiver verbose
Diagnostic information:
Voltage (V) :3.27
Bias Current (mA) :89.76
Bias High Threshold (mA) :130.00
Bias Low Threshold (mA) :1.00
Current RX Power (dBm) :-3.26
Default RX Power High Threshold (dBm) :-0.50
Default RX Power Low Threshold (dBm) :-23.98
Current TX Power (dBm) :0.71
Default TX Power High Threshold (dBm) :5.90
Default TX Power Low Threshold (dBm) :-5.90
// current Rx/Tx readings sitting inside their thresholds -> the optic is not the fault
Um transceptor perfeitamente bom e uma fibra perfeitamente boa ainda podem se recusar a linkar se forem o par errado um para o outro.
<HUAWEI> display interface 10ge1/0/2 transceiver
10GE1/0/2 transceiver information:
Common information:
Transceiver Type :10GBASE_USR
Connector Type :LC
Wavelength (nm) :850
Transfer Distance (m) :20(62.5um/125um OM1) 50(50um/125um OM2)
Alarm information:
Non-Huawei-certified transceiver
// compare Transceiver Type / Wavelength / Transfer Distance against the far end,
// not just against the local interface spec
Só vale a pena verificar depois que os quatro primeiros ramos voltarem limpos — mas quando chega aqui, geralmente essa é a resposta.
Cada um parecia idêntico à primeira vista — uma porta travada em DOWN — e cada um acabou sendo um ramo diferente da árvore acima.
SINTOMAApós uma perda de energia não planejada e reinício, várias interfaces permaneceram fisicamente DOWN sem nenhuma mudança de configuração no histórico recente, e os dispositivos peer não mostraram nenhum reinício ou failover próprio.
CAUSAdisplay interface mostrava a porta ainda em Port Mode: COMMON FIBER embora o engenheiro no local tenha confirmado que essa interface na verdade usava uma porta Combo cabeada para cobre. display interface transceiver verbose confirmou que o óptico instalado não tinha identificação de fabricante HUAWEI — um transceptor não certificado. Depois do reinício, a porta falhou em detectar corretamente qual meio físico estava realmente presente e ficou travada reportando modo fibra em vez de mudar para modo cobre, então nunca subiu.
SOLUÇÃOReencaixar o óptico não resolveu. Substituí-lo por um transceptor certificado pela Huawei resolveu — Port Mode mostrou corretamente COMMON COPPER depois e a interface subiu imediatamente. Ópticos não certificados não são validados contra o próprio comportamento do firmware do dispositivo, e esse tipo de falha de detecção de modo em caso extremo é exatamente o risco que a certificação pretende descartar.
<HUAWEI> display interface 10ge1/0/2
10GE1/0/2 current state : DOWN
Port Mode: COMMON FIBER//should have been COMMON COPPER for this build
<HUAWEI> display interface 10ge1/0/2 transceiver verbose
Vendor Name :*********
Alarm information: Non-Huawei-certified transceiver
// after replacing with a certified transceiver:
<HUAWEI> display interface 10ge1/0/2
10GE1/0/2 current state : UP
Port Mode: COMMON COPPER//correct mode, port came Up
SINTOMAUm link óptico 10GE rodando 210 metros em fibra multimodo e ópticos multimodo oscilava física e repetidamente entre Up e Down, com entradas de log de estado de link correspondentes nos dois lados e nenhuma incompatibilidade de configuração em lugar nenhum.
CAUSAdisplay interface transceiver verbose confirmou que o transceptor era certificado pela Huawei com a potência de recepção e transmissão ambas dentro de seus limites — o óptico em si não era a falha. O campo Transfer Distance no transceptor mostrava classificações de suporte multimodo que variam por grau de fibra: aproximadamente 300m em fibra OM3 mas 400m em OM4. A 210 metros o link estava dentro do alcance da OM4 mas empurrando o limite do que a fibra realmente instalada (multimodo não-OM4) conseguia transportar de forma confiável, e a dispersão cromática nessa distância era suficiente para causar perda de link intermitente.
SOLUÇÃOCombine ópticos multimodo especificamente com fibra de grau OM4 quando o trajeto se aproximar de 300m ou mais, em vez de assumir que qualquer combinação multimodo-multimodo está automaticamente correta — a regra de correspondência (óptico monomodo com fibra monomodo, multimodo com multimodo) é necessária mas não suficiente quando a distância aumenta. Substituir a fibra por OM4 resolveu a oscilação.
<HUAWEI> display interface 10ge1/0/1 transceiver verbose
Transceiver Type:10GBASE_SR_SFP
Transfer Distance(m):300(50um/125um OM3),400(50um/125um OM4)//OM4 carries furthest
Vendor Name:HUAWEI// certified optic, ruled out as the fault
Current RX Power (dBm) :-2.45//within threshold
Current TX Power (dBm) :-1.86//within threshold
// optic and power both clean -> look at fiber grade vs. the 210m run length
SINTOMAUm link de cobre para um equipamento de outro fabricante não subia, enquanto o mesmo cabeamento físico e porta funcionavam corretamente quando reconectados temporariamente a outro dispositivo do mesmo fabricante.
CAUSAdisplay interface mostrava a porta em si saudável — fisicamente UP internamente, velocidade e duplex corretos, Negotiation: ENABLE — sem nada na configuração ou cabeamento que explicasse a falha contra esse peer específico. Implementações de autonegociação não são idênticas em todos os fabricantes, e esse emparelhamento simplesmente não concordou em parâmetros durante a negociação, mesmo que a configuração de cada lado fosse individualmente válida.
SOLUÇÃOConfigure negotiation disable na interface do lado Huawei para forçar o modo sem autonegociação. O peer subiu imediatamente. Se desativar apenas a autonegociação não for suficiente em um caso semelhante, continue definindo explicitamente speed para corresponder ao peer, já que uma porta não negociada também precisa ter sua taxa configurada em vez de assumida.
<HUAWEI> display interface 10ge 1/0/1
10GE1/0/1 current state : UP
Duplex: FULL,Negotiation: ENABLE//auto-negotiation is on, but the peer still won't link
<HUAWEI> system-view
[HUAWEI] interface 10ge 1/0/1
[HUAWEI-10GE1/0/1] negotiation disable
// peer interface came Up immediately after switching off auto-negotiation
SINTOMAA porta em si permaneceu fisicamente UP o tempo todo, mas o contador de erros CRC da interface continuava subindo a cada verificação — uma falha de combustão mais lenta que um DOWN total, mas que degrada a vazão da mesma forma.
CAUSAUm cabo degradado — desgaste interno, um conector marginal, ou dano físico ao longo do trajeto — corrompe uma fração dos quadros em trânsito sem derrubar o link de vez. Cada quadro corrompido falha em sua sequência de verificação de quadro e incrementa o contador de CRC, o que é um sinal precoce confiável de um problema de camada física mesmo enquanto a porta mostra Up.
SOLUÇÃOTrate primeiro um contador de CRC crescente como um sintoma de camada física, antes de olhar para qualquer outro lugar. Substituir o cabo resolveu este caso; vale a pena executar virtual-cable-test em qualquer interface com uma contagem de CRC crescente mesmo que current state ainda mostre UP.
<HUAWEI> display this interface
10GE1/0/1 current state : UP
CRC :4782,Giants :0
// port shows UP, but CRC count keeps growing on repeated checks ->
// treat as a physical-layer / cable fault even without a DOWN state
Tiradas diretamente do campo — aquelas para as quais vale a pena ter uma resposta pronta.
Execute display interface transceiver verbose para o bloco de diagnóstico completo, ou display interface transceiver brief apenas para os números de potência. Current RX Power e Current TX Power são as leituras que importam; compare-as com os próprios campos Default RX/TX Power High/Low Threshold daquele mesmo módulo, que viajam com o transceptor em vez de serem um número fixo para todos os módulos.
1000BASE-T exige cabeamento Cat5e ou melhor com os quatro pares de fios internos saudáveis para que o link negocie em gigabit. Um par degradado, um conector solto, ou um cabo abaixo da especificação muitas vezes ainda negocia — só que cai para 100M em vez de 1000M. Execute virtual-cable-test para verificar diretamente a saúde dos pares, e configure speed auto explicitamente se quiser forçar uma tentativa de renegociação.
Ópticos BiDi precisam ser usados em pares complementares, não idênticos — uma ponta precisa de um módulo TX1310/RX1490 e a outra precisa de TX1490/RX1310. Dois módulos com a mesma atribuição de comprimento de onda nas duas pontas nunca vão linkar não importa quão saudável esteja a fibra, já que ambos estão transmitindo e escutando no mesmo comprimento de onda em vez de comprimentos opostos.
Uma porta óptica 10GE pode aceitar um módulo 1GE e vai rodar em 1GE — a porta em si é capaz da taxa mais baixa. O inverso não funciona: uma interface óptica classificada como 1GE não pode ser forçada a rodar um módulo classificado como 10GE, já que a interface física e a taxa SerDes não são construídas para isso. Sempre combine a velocidade nominal do módulo com o que a porta física realmente foi projetada para rodar.
Verifique primeiro a causa de ERROR DOWN se o log mostrar uma — a proteção de link-flap disparando repetidamente é em si diagnóstica de uma camada física instável por baixo, não uma falha separada. Se não houver causa de ERROR DOWN, verifique o CRC e outros contadores de erro (um cabo falhando degrada antes de falhar de vez), depois a potência óptica se for um link de fibra, e só trate como uma falha de hardware depois que tanto o cabeamento quanto a óptica saírem limpos sob loopback internal.
Esta nota se baseia no modelo de classificação de falhas de interface física do switch Huawei série S e seus comandos display interface / display interface transceiver / virtual-cable-test, além dos casos de campo por trás deles. Se o seu switch for de outro fabricante, os comandos exatos mudam, mas a ordem de diagnóstico de seis ramos — humano/proteção, hardware, meio, uso/incompatibilidade, ambiente, e o próprio óptico — se aplica diretamente. Não cobre em profundidade falhas de divisão/combinação de interface ou cenários de perda de pacotes em estado Up; esses estão em uma seção relacionada do mesmo manual fonte e merecem seu próprio tratamento separado.
Envie-nos a saída de display interface e display interface transceiver verbose, e ajudamos você a identificar em qual dos seis ramos você realmente está.