EF_VI API初始化失败主因是efx驱动与libefvi版本不匹配；发包延迟突增因未及时ef_vi_poll()回收TX描述符；收包丢帧因未ef_vi_receive_pop()释放RX缓冲区；多线程共享VI实例会导致未定义行为。
EF_VI API 初始化失败：ef_vi_init() 返回 -1
常见现象是 ef_vi_init() 直接返回 -1，日志里看不到具体原因。这通常不是权限问题（root 已满足），而是 EF_VI 依赖内核驱动 efx 和用户态库 libefvi 的版本严格匹配。Solarflare 官方不保证跨 minor 版本兼容——比如你装了 ONLOAD 8.0.0 驱动，却用 8.1.0 的 libefvi.so，ef_vi_init() 就会静默失败。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 运行
modinfo efx确认内核模块版本，再用ldd your_app | grep efvi和objdump -s -j .comment /usr/lib/libefvi.so（或查看其所在 deb/rpm 包名）核对用户态库版本是否完全一致 -
ef_vi_init()前必须调用ef_driver_handle_create()获取有效句柄；漏掉这步或传入 NULL 句柄，也会返回 -1 - 确保网卡已绑定到
efx驱动（非sfc或igb），用lspci -k -s $(ethtool -i ethX | awk '/bus-info/ {print $NF}')验证
发包延迟突增：ef_vi_transmit() 后未及时 ef_vi_poll()
EF_VI 不自动回收完成的 TX 描述符，必须靠 ef_vi_poll() 扫描完成队列（TXQ CQ）。如果只发包不轮询，TXQ 很快填满，后续 ef_vi_transmit() 会阻塞或失败（返回 -EAGAIN），造成毫秒级抖动——这和“直通”预期完全相悖。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 不能把
ef_vi_poll()放在发包循环外；推荐每发 N 个包（N ≤ 16）后调用一次，或用ef_eventq_next()+ef_vi_transmit_done()做事件驱动式回收 - 注意
ef_vi_transmit_pio()虽快但受限于 PIO buffer 大小（通常 128B），超长包强制 fallback 到 DMA，反而更慢；判断包长是否 ≤vi->vi_piobuf_len再选路径 - 避免在 tight loop 中反复调用
ef_vi_transmit()却不检查返回值——-EAGAIN 必须处理，否则逻辑卡死
收包丢帧：ef_vi_receive_push() 后未同步更新 RX 环指针
EF_VI 的 RX 环是生产者-消费者模型，应用负责推进环上“已提交”位置（ef_vi_receive_push()），但内核负责推进“已完成”位置。若应用 push 后不调用 ef_vi_receive_pop() 或 ef_vi_receive_unbundle() 清空已收包，RX 环缓冲区会被占满，新包直接被网卡丢弃，ethtool -S ethX 里 rx_nodesc_drop_cnt 会上升。
实操建议：
立即学习“C++免费学习笔记（深入）”；
-
ef_vi_receive_push()是预分配 RX 描述符，真正释放 buffer 给网卡重用的是ef_vi_receive_pop()——二者必须成对出现，且 pop 必须在包处理完之后 - 不要用
ef_vi_receive_unbundle()处理单包（它为 multi-segment 设计），简单场景用ef_vi_receive_pop()更稳 - 检查
ef_vi_receive_space()返回值，若接近 0，说明 RX 环快满，需加快 pop 频率或增大 ring size（初始化时设vi_attr.rx_ring_size≥ 2048）
多线程竞争 VI：共享 ef_vi 实例引发 undefined behavior
EF_VI 的 ef_vi 结构体**不是线程安全的**。多个线程并发调用 ef_vi_transmit() 或 ef_vi_poll() 会破坏内部状态（如 CQ 指针、DMA 描述符索引），导致随机丢包、内存越界甚至段错误——这种问题在线上高负载时才暴露，复现困难。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 一个
ef_vi实例只绑定一个线程；需要多线程收发，就创建多个 VI（每个绑独立 RX/TX queue），用ef_vi_set_evq()显式指定 event queue - 绝对不要在信号处理函数中调用任何 EF_VI API（包括
ef_vi_poll()），SIGIO/SIGPOLL 的上下文不可控 - 如果必须跨线程传递数据，用 lock-free ring buffer（如 SPSCQueue）中转 payload，VI 操作始终留在专属线程内
EF_VI 的“低延迟”前提是零拷贝 + 内核旁路，但它的 API 表面简洁，底层状态机耦合极深。最容易被忽略的是：所有 VI 操作都隐含对硬件寄存器和共享内存的读写，一旦时序错乱（比如 poll 和 transmit 交叉、pop 和 push 错位），错误不会立刻报出，而是延后表现为吞吐骤降或延迟毛刺——这时候得回过头一行行核对 init → push/pop → poll → done 的闭环是否完整。
