4. 路由表项缺失：现象描述与初步定位思路

在 DPDK l3fwd 应用中，路由表项缺失是最常见的转发故障之一。当数据包到达网卡后，软件查表失败，导致报文无法被正确转发，最终表现为丢包或异常回环。本节将系统描述该故障的典型现象，并给出从应用层到驱动层的分层定位思路。

4.1 故障现象描述

路由表项缺失的典型表现可归纳为以下四类：

4.2 初步定位思路：分层排查法

路由表项缺失的排查应遵循“应用层 → 数据层 → 驱动层”的自顶向下顺序。每一层都有对应的检查点和工具。

4.3 应用层排查：路由表初始化验证

大多数路由表项缺失的根因在应用层初始化阶段。以下是标准检查清单：

1. 确认 LPM 表创建成功：检查 rte_lpm_create() 返回值是否为 NULL，以及 max_rules 和 number_tbl8s 参数是否满足路由规模。
2. 验证路由规则添加：使用 rte_lpm_add() 后立即调用 rte_lpm_is_rule_present() 确认规则生效。
3. 检查默认路由：如果配置了 0.0.0.0/0，确保其 next_hop 指向有效端口，且优先级低于精确匹配规则。
4. 多线程安全：如果多个 lcore 共享同一个 LPM 表，确认在 rte_lpm_add() 期间没有并发 rte_lpm_lookup() 操作。

// 典型的路由表初始化代码片段（含错误检查）
struct rte_lpm *lpm;
struct rte_lpm_config config = {
    .max_rules = 1024,
    .number_tbl8s = 256,
    .flags = 0,
};

lpm = rte_lpm_create("l3fwd_lpm", SOCKET_ID_ANY, &config);
if (lpm == NULL) {
    rte_exit(EXIT_FAILURE, "Unable to create LPM table\n");
}

// 添加路由规则并验证
uint8_t next_hop = 1; // 对应端口1
int ret = rte_lpm_add(lpm, ipv4_addr, depth, next_hop);
if (ret < 0) {
    printf("Failed to add route: %d\n", ret);
}

// 验证规则是否存在
int present = rte_lpm_is_rule_present(lpm, ipv4_addr, depth, &next_hop);
if (present != 1) {
    printf("Rule not present after add!\n");
}

4.4 数据层排查：查表逻辑与 key 构造

如果应用层初始化无误，则需深入数据层的查表逻辑。关键检查点包括：

// 正确的查表逻辑（含错误处理）
uint32_t ip_dst = rte_be_to_cpu_32(ipv4_hdr->dst_addr);
uint8_t next_hop;
int ret = rte_lpm_lookup(lpm, ip_dst, &next_hop);

if (ret == 0) {
    // 查表成功，转发到 next_hop 对应的端口
    send_packet(mbuf, next_hop);
} else if (ret == -ENOENT) {
    // 路由表项缺失：记录统计、丢包或走默认路由
    stats->missed_packets++;
    rte_pktmbuf_free(mbuf);
} else {
    // 其他错误（如参数无效）
    stats->error_packets++;
    rte_pktmbuf_free(mbuf);
}

4.5 驱动层排查：确认 NIC 接收正常

在确认软件查表逻辑无误后，需要排除硬件层面的干扰。驱动层排查的核心是确认 NIC 正确接收了数据包，并且 mbuf 中的 IP 地址字段是完整的。

• 检查 NIC 统计：使用 rte_eth_stats_get() 查看 ipackets、imissed、ierrors。如果 imissed 持续增长，说明硬件存在丢包，与路由表项无关。
• 验证 mbuf 完整性：在查表前打印 mbuf->data_len 和 ipv4_hdr->dst_addr，确认数据包未被截断。
• RSS 哈希检查：如果使用多队列，确认 RSS 哈希正确分发，避免同一个流的数据包被分发到不同 lcore 导致乱序。
• 流控制（Flow Control）：检查 NIC 的流控制是否开启，避免对端背压导致丢包。

// 驱动层统计检查示例
struct rte_eth_stats stats;
rte_eth_stats_get(port_id, &stats);

printf("Port %u stats:\n", port_id);
printf("  ipackets: %lu\n", stats.ipackets);
printf("  opackets: %lu\n", stats.opackets);
printf("  imissed:  %lu\n", stats.imissed);   // 硬件丢包
printf("  ierrors:  %lu\n", stats.ierrors);   // 硬件错误
printf("  rx_nombuf:%lu\n", stats.rx_nombuf); // mbuf 耗尽

if (stats.imissed > 0) {
    printf("WARNING: Hardware packet loss detected!\n");
}

4.6 快速定位工具与命令汇总