从lwIP源码看TCP连接终止：为什么你的errf回调总在LAST

深入解析lwIP中TCP连接终止与errf回调机制

1. TCP连接终止流程全景剖析

在嵌入式网络开发中，理解TCP协议栈的内部工作机制至关重要。lwIP作为轻量级TCP/IP协议栈，其TCP状态机实现与标准RFC定义略有差异，特别是在连接终止流程中。

TCP连接终止的四种典型场景：

主动关闭：应用程序调用tcp_close()正常终止连接
被动关闭：收到对端FIN报文后的关闭流程
异常终止：通过tcp_abort()强制终止连接
超时终止：由tcp_slowtmr()触发的超时关闭

// TCP状态定义（lwIP 2.0.0+）
enum tcp_state {
    CLOSED,      // 连接完全关闭
    LISTEN,      // 监听状态
    SYN_SENT,    // 已发送SYN
    SYN_RCVD,    // 已接收SYN
    ESTABLISHED, // 连接已建立
    FIN_WAIT_1,  // 已发送FIN，等待ACK
    FIN_WAIT_2,  // 已收到FIN的ACK，等待对端FIN
    CLOSE_WAIT,  // 已收到FIN，等待应用关闭
    CLOSING,     // 双方同时关闭
    LAST_ACK,    // 已发送FIN，等待最终ACK
    TIME_WAIT    // 等待2MSL超时
};

2. errf回调的触发机制深度解析

errf回调是lwIP协议栈向应用层报告TCP异常的核心机制，其注册通过tcp_err(pcb, errf)接口完成。该回调主要在三种情况下被触发：

错误类型	触发条件	典型场景
ERR_RST	收到有效RST报文	对端强制终止连接
ERR_CLSD	非正常关闭连接	应用未处理LAST_ACK状态
ERR_ABRT	内部异常终止	资源不足或超时

关键代码路径分析：

// tcp_input.c中的处理逻辑
void tcp_input(struct pbuf *p, struct netif *inp) {
    if (recv_flags & TF_RESET) {
        TCP_EVENT_ERR(pcb->state, pcb->errf, pcb->callback_arg, ERR_RST);
        tcp_pcb_remove(&tcp_active_pcbs, pcb);
        tcp_free(pcb);
    }
    else if (recv_flags & TF_CLOSED) {
        if (!(pcb->flags & TF_RXCLOSED)) {
            TCP_EVENT_ERR(pcb->errf, pcb->callback_arg, ERR_CLSD);
        }
        tcp_pcb_remove(&tcp_active_pcbs, pcb);
        memp_free(MEMP_TCP_PCB, pcb);
    }
}

3. LAST_ACK状态的特殊处理

LAST_ACK状态下的errf回调触发是开发者经常遇到的困惑点。当出现以下情况时，协议栈会强制触发ERR_CLSD回调：

对端发送FIN并进入LAST_ACK状态
本地应用未调用tcp_close()进行响应
收到对端对FIN的ACK确认

状态转换示意图：

ESTABLISHED → CLOSE_WAIT → LAST_ACK → (应用未处理) → 触发ERR_CLSD

重要提示：当errf回调被调用时，对应的TCP控制块(PCB)已经被释放，此时不能再访问PCB的任何成员变量。这是许多内存访问错误的根源。

4. 异常终止的完整处理流程

lwIP内部通过tcp_abandon()函数处理异常终止，其核心逻辑包括：

从活动PCB列表中移除
释放未发送数据缓冲区
必要时发送RST报文
调用errf回调通知应用层

// tcp.c中的异常处理代码
void tcp_abandon(struct tcp_pcb *pcb, int reset) {
    tcp_pcb_purge(pcb);  // 清理数据缓冲区
    if (reset) {
        tcp_rst(pcb, pcb->snd_nxt, pcb->rcv_nxt, 
               &pcb->local_ip, &pcb->remote_ip,
               pcb->local_port, pcb->remote_port);
    }
    TCP_EVENT_ERR(last_state, errf, errf_arg, ERR_ABRT);
    tcp_free(pcb);
}

5. 实战调试技巧与最佳实践

常见问题排查表：

现象	可能原因	解决方案
errf在LAST_ACK被调用	应用未处理关闭流程	确保正确调用tcp_close()
ERR_ABRT频繁出现	资源不足或配置不当	检查内存池大小和PCB数量
ERR_RST意外触发	对端异常终止	检查网络连通性和对端状态

性能优化建议：

合理设置重传参数：

// 调整重传次数（需在opt.h中修改）
#define TCP_MAXRTX      12  // 最大数据重传次数
#define TCP_SYNMAXRTX   6   // SYN重传最大次数

优化定时器处理：

// 调整关键超时参数（单位：500ms）
#define TCP_FIN_WAIT_TIMEOUT 40    // FIN_WAIT_2超时（20秒）
#define TCP_SYN_RCVD_TIMEOUT 40    // SYN_RCVD超时（20秒）
#define TCP_MSL             600    // 最大分段寿命（5分钟）

内存管理策略：

// 合理配置内存池大小（在lwipopts.h中）
#define MEMP_NUM_TCP_PCB        5    // 并发TCP连接数
#define MEMP_NUM_TCP_SEG        16   // TCP分段缓冲区数量

通过深入理解lwIP中TCP连接终止机制和errf回调原理，开发者可以构建更健壮的嵌入式网络应用，有效处理各种异常场景，提升系统可靠性。