二层网络环路是运维中典型的故障形态，故障发生时交换机端口指示灯会异常高频闪烁，CPU使用率飙升，甚至整个园区网络不可用。生成树协议（Spanning Tree Protocol，STP）通过在逻辑上阻塞某些端口来打破物理环路，因此能否准确读取端口处于Blocking还是Forwarding状态，直接决定了环路检测的准确性。Ruby语言凭借简洁的语法和成熟的SNMP库，可以快速编写脚本对交换机进行轮询，完成环路识别与生成树状态采集。

本文将以常见支持SNMP的二层交换机为例，从MIB对象解析、SNMP查询、Ruby实现和告警输出四个层次展开，给出可直接用于生产环境的检测方案。

交换机环路的形成与生成树端口状态

当交换机之间存在多条物理链路且未运行生成树时，广播帧、未知单播帧会在环路上无限复制，导致MAC地址表震荡和带宽耗尽，这就是典型的广播风暴。生成树协议通过选举根桥，并在每个非根桥上选择一个根端口和若干个指定端口，其余冗余端口进入Blocking状态，从逻辑上将环路剪枝为一棵树。理解端口状态的含义是检测环路的基础。

标准STP定义了Disabled、Blocking、Listening、Learning、Forwarding五种状态。其中Blocking状态表示端口不转发用户数据，仅监听BPDU；Forwarding表示端口正常转发。当端口长时间停留在Listening或Learning状态，或者出现大量Forwarding端口且没有Blocking端口时，需要怀疑生成树配置异常或环路保护失效。网络管理员可以通过定期采集这些状态来提前发现隐患。

在SNMP MIB中，这些状态可以通过BRIDGE-MIB下的dot1dStp组读取，具体OID为1.3.6.1.2.1.17.2.16.1.4（dot1dStpPortState），每个端口对应一个实例。同时还可以读取dot1dStpPortDesignatedRoot、dot1dStpPortDesignatedBridge等对象来确认端口角色。了解这些OID的含义后，就可以开始编写采集脚本。

使用Ruby通过SNMP获取生成树数据

Ruby操作SNMP最常用的库是snmp，它支持SNMP v1、v2c和v3，提供了get、get_next、walk等便捷方法。在开始之前需要确保交换机已开启SNMP读写权限，并确认团体名（community string）。以下示例演示如何连接到一台交换机并遍历所有端口的STP状态。

代码首先创建一个Manager对象，指定目标地址和团体名，然后使用walk方法遍历OID子树。walk方法内部会自动执行get_next直到超出子树范围，非常适合批量读取端口状态。在代码块之后，我们还可以增加超时和重试逻辑，以应对网络抖动。

require 'snmp'
include SNMP
# 连接交换机
manager = Manager.new(:Host => '192.168.1.1', :Community => 'public', :Version => :SNMPv2c, :Timeout => 2, :Retries => 1)
# dot1dStpPortState OID
base_oid = ObjectId.new('1.3.6.1.2.1.17.2.16.1.4')
puts "Port State Walk for 192.168.1.1"
manager.walk(base_oid) do |vb|
  # vb.name 类似 1.3.6.1.2.1.17.2.16.1.4.1
  port_index = vb.name.to_s.split('.').last
  state_code = vb.value.to_i
  state_name = case state_code
               when 1 then 'Disabled'
               when 2 then 'Blocking'
               when 3 then 'Listening'
               when 4 then 'Learning'
               when 5 then 'Forwarding'
               else 'Unknown'
               end
  puts "Port #{port_index}: #{state_name} (#{state_code})"
end
manager.close

这段脚本会输出每个端口的STP状态，其中端口索引是从OID最后一个子标识符获得的。实际部署时，可以将端口索引与interface表（ifTable）关联，得到具体的端口名称。需要注意的是，不同厂商交换机可能有私有MIB扩展，但标准的BRIDGE-MIB在大部分二层交换机上都得到支持。

识别异常环路：基于端口状态的检测逻辑

获取端口状态只是第一步，环路检测的核心在于判断端口状态是否符合预期。在一个正常的生成树拓扑中，每台非根交换机通常会有一个根端口处于Forwarding状态，若干指定端口处于Forwarding状态，而连接冗余链路的端口会处于Blocking状态。如果某台交换机所有端口都是Forwarding状态，且没有Blocking端口，那么很可能生成树没有生效，存在物理环路。

我们可以编写Ruby脚本来统计每台交换机的端口状态分布，若发现没有Blocking端口且Forwarding端口数量大于等于2，则输出告警。此外，还可以检查根桥是否发生变化：读取dot1dStpRootPort和dot1dStpDesignatedRoot，如果根桥MAC频繁切换，说明拓扑不稳定，可能由环路引起。

以下代码展示了如何对多台交换机执行状态统计并输出异常告警。我们使用一个简单的循环遍历交换机列表，统计状态为Forwarding的端口数量，并检查是否存在Blocking端口。如果存在两台以上交换机同时出现异常，则生成汇总报告。

require 'snmp'
include SNMP
switches = [
  { :host => '192.168.1.1', :community => 'public' },
  { :host => '192.168.1.2', :community => 'public' },
  { :host => '192.168.10.1', :community => 'private' }
]
base_oid = ObjectId.new('1.3.6.1.2.1.17.2.16.1.4')
alerts = []
switches.each do |sw|
  manager = Manager.new(:Host => sw[:host], :Community => sw[:community], :Version => :SNMPv2c, :Timeout => 2, :Retries => 1)
  forward_count = 0
  block_count = 0
  port_states = {}
  manager.walk(base_oid) do |vb|
    port_index = vb.name.to_s.split('.').last.to_i
    state_code = vb.value.to_i
    port_states[port_index] = state_code
    forward_count += 1 if state_code == 5
    block_count += 1 if state_code == 2
  end
  if forward_count >= 2 and block_count == 0
    alerts << "#{sw[:host]} has #{forward_count} forwarding ports but no blocking port, possible loop!"
  end
  puts "#{sw[:host]} - Forwarding: #{forward_count}, Blocking: #{block_count}"
  manager.close
end
if alerts.empty?
  puts "No obvious loop risk detected."
else
  puts "Loop alerts:"
  alerts.each { |a| puts a }
end

批量轮询、性能优化与告警集成

当交换机数量较多时，串行轮询可能会非常耗时，甚至超过监控系统的采集周期。Ruby的GIL虽然限制了CPU并行，但SNMP操作主要是IO等待，因此可以使用线程池进行并发采集。一个简单的做法是使用Queue和多个worker线程，每个线程独立处理一台交换机的SNMP会话。

另外，SNMP超时设置需要根据网络规模调整，过短的超时会导致误报，过长的超时则会拖慢整个任务。建议在代码中加入重试机制，并对不可达设备进行跳过和记录，而不是直接中断。可以将采集结果输出为JSON或写入时间序列数据库，配合Grafana等工具实现可视化。

下面给出一个使用线程池的简化示例，每个线程负责一台交换机，采集结果存入一个线程安全的数组。这样可以显著缩短整体采集时间。

require 'snmp'
require 'thread'
include SNMP
switches = (1..10).map { |i| { :host => "192.168.1.#{i}", :community => 'public' } }
results = Queue.new
threads = []
switches.each do |sw|
  threads << Thread.new do
    begin
      manager = Manager.new(:Host => sw[:host], :Community => sw[:community], :Version => :SNMPv2c, :Timeout => 3, :Retries => 2)
      base_oid = ObjectId.new('1.3.6.1.2.1.17.2.16.1.4')
      forward_count = 0
      block_count = 0
      manager.walk(base_oid) do |vb|
        state_code = vb.value.to_i
        forward_count += 1 if state_code == 5
        block_count += 1 if state_code == 2
      end
      results << { :host => sw[:host], :forward => forward_count, :block => block_count }
      manager.close
    rescue => e
      results << { :host => sw[:host], :error => e.message }
    end
  end
end
threads.each(&:join)
until results.empty?
  res = results.pop
  if res[:error]
    puts "Error for #{res[:host]}: #{res[:error]}"
  else
    puts "#{res[:host]} - Forwarding: #{res[:forward]}, Blocking: #{res[:block]}"
  end
end

通过上述方案，Ruby可以胜任交换机环路检测和生成树状态监控的任务，尤其适合中小规模网络的轻量级运维。实际使用中还可以结合定时任务（如cron）周期性执行，并将异常结果发送到邮件或IM告警通道，形成完整的自动化闭环。