1. 课程导论：l3fwd 应用场景与故障排查总览
DPDK l3fwd（Layer 3 Forwarding）是数据平面开发套件（DPDK）中最经典的三层转发示例应用。它直接从网卡轮询数据包，绕过内核协议栈，在用户态完成路由查找与转发。本课程将深入剖析 l3fwd 在生产环境中常见的路由故障，从路由表项缺失到网卡丢包，系统性地讲解排查方法与优化策略。
1.1 l3fwd 的典型应用场景
l3fwd 广泛应用于高性能网络转发场景，其核心价值在于极低的延迟与高吞吐量。下表列出了 l3fwd 的主要应用领域与对应需求：
| 应用场景 | 核心需求 | l3fwd 优势 |
|---|---|---|
| 软件路由器 / vRouter | 高速 IP 包转发 | 用户态轮询，无上下文切换开销 |
| NFV 虚拟网络功能 | VNF 间快速数据通路 | 支持多队列、RSS 与 NUMA 亲和性 |
| 5G UPF 用户面功能 | GTP-U 封装与转发 | 可扩展为自定义流表处理 |
| 数据中心负载均衡器 | 五元组哈希分发 | 精确流表匹配与快速转发 |
| 安关 / 防火墙 | ACL 规则匹配 | 结合 LPM 与精确匹配实现高性能过滤 |
关键认知： l3fwd 并非一个完整的路由器协议栈，它不运行 OSPF/BGP 等动态路由协议。其路由表通常由控制平面（如 Linux 内核或独立的路由协议进程）下发，l3fwd 仅负责高速数据平面转发。故障排查时，必须区分控制平面与数据平面。
1.2 l3fwd 数据平面架构
理解 l3fwd 的内部数据流是故障排查的基础。下图展示了 l3fwd 从网卡收包到转发的核心流水线：
1.3 故障排查总览：从表项缺失到 NIC 丢包
本课程将故障排查分为两大主线：路由表项问题与网卡丢包问题。两者往往相互关联，例如路由表项缺失会导致大量查表失败，进而触发 NIC 的丢包统计计数器增长。
1.3.1 路由表项缺失故障树
- 控制平面未下发：检查路由协议进程（如 FRR、Bird）是否正常运行，路由表是否同步到 DPDK LPM 表。
- LPM 表结构损坏：tbl8 扩展表分配失败、内存越界写入导致表项被覆盖。
- 哈希冲突与精确匹配失效：长前缀路由与默认路由的优先级冲突。
- ARP 表项老化：下一跳 MAC 地址未及时更新，导致转发失败。
1.3.2 NIC 丢包故障树
- 硬件丢包：RX 描述符环溢出、PCIe 带宽瓶颈、MAC 层 CRC 错误。
- 驱动丢包：mbuf 池耗尽、收包队列未使能、RSS 哈希配置错误。
- 软件丢包：应用程序处理速度跟不上收包速率、单核过载、Cache 抖动。
- 流控与反压：PFC 暂停帧导致端口阻塞、head-of-line blocking。
排查原则： 先硬件后软件，先统计后日志，先隔离后修复。利用 DPDK 自带的
rte_eth_stats_get() 与 rte_eth_xstats_get() 获取精确的丢包计数器，结合 perf 与 gdb 定位软件瓶颈。
1.4 课程知识体系与学习路径
本课程共 30 章，分为四大模块。下表展示了各模块的核心内容与学习目标：
| 模块 | 章节范围 | 核心内容 | 学习目标 |
|---|---|---|---|
| 基础篇 | 1-5 | l3fwd 架构、LPM 表原理、NIC 驱动配置 | 掌握 l3fwd 数据流与基础配置 |
| 路由表项篇 | 6-12 | 表项缺失、哈希冲突、ARP 老化、控制平面同步 | 独立排查路由表项相关故障 |
| NIC 丢包篇 | 13-22 | 硬件丢包、驱动丢包、mbuf 管理、流控、RSS 调优 | 系统化定位与解决 NIC 丢包问题 |
| 实战与调优篇 | 23-30 | 多核负载均衡、NUMA 优化、DDOS 防护、生产案例 | 具备生产环境性能调优与故障应急能力 |
1.5 必备工具与调试环境
在开始故障排查之前，请确保已准备好以下工具与环境：
- DPDK 版本：建议 21.11 LTS 或更高版本，支持
rte_flow与rte_eth_xstats。 - 网卡：Intel XL710 / XXV710 或 Mellanox ConnectX-5/6，支持多队列与硬件卸载。
- 调试工具：
dpdk-proc-info、dpdk-testpmd、gdb、perf、ethtool。 - 监控工具：
sar、mpstat、numactl、tcpdump（仅用于控制平面）。
重要提示： 在生产环境中使用
tcpdump 抓取 DPDK 端口的数据包时，必须通过 --vdev=net_pcap0 或硬件镜像端口，否则会严重干扰 DPDK 的轮询模式，导致大量丢包。