You need to enable JavaScript to run this app. STM32F4基于FreeModbus的Modbus TCP从站拔插网线后主站变更远程端口无法重连
优惠活动
大模型
产品
解决方案
定价
更多

STM32F4基于FreeModbus的Modbus TCP从站拔插网线后主站变更远程端口无法重连

STM32F4平台FreeModbus TCP从站断网重连异常修复指南

核心问题本质

  • 网线被物理拔出时,从站侧LwIP协议栈无法收到旧TCP连接的FIN、RST终止报文,旧连接对应的PCB控制块既不会触发正常关闭流程,也不会及时上报连接错误,导致全局pxPCBClient指针会一直持有这个完全失效的旧连接地址,永远不会被自动置空。
  • 现有accept回调的逻辑是只要pxPCBClient非空,所有新接入的连接都会被直接拒绝,哪怕PC端已经更换了新的临时端口发起重连,也根本走不到分配新客户端PCB的分支,最终表现为重连完全失败。

分步修复方案

1. 开启TCP Keepalive探测,解决死连接长期占位的问题

这是物理断网场景下最有效的探测手段,让协议栈主动识别并清理失效连接:

注意:使用该功能前,需要在LwIP配置头文件lwipopts.h中开启宏定义#define LWIP_TCP_KEEPALIVE 1,否则后续的Keepalive配置函数不会生效。

在accept回调中,给新接入的客户端PCB注册完原有回调之后,追加Keepalive相关配置:

pxPCBClient = pxPCB;

// 追加的Keepalive配置
tcp_keepalive(pxPCB);                   // 开启连接保活探测
tcp_keepidle(pxPCB, 10000);            // 连接空闲10s后启动第一次保活探测
tcp_keepintvl(pxPCB, 3000);            // 每3s发送一次保活探测包
tcp_keepcnt(pxPCB, 3);                 // 连续3次探测无响应就判定连接失效
  • 关键补全操作:在prvvMBTCPPortError错误回调中,一定要清空全局的pxPCBClient指针。很多FreeModbus移植版本漏了这步,哪怕协议栈识别到连接失效,指针没清还是会继续拒绝新连接:
void prvvMBTCPPortError(void *pvArg, err_t xErr)
{
    struct tcp_pcb *pxCurrentPCB = (struct tcp_pcb *)pvArg;
    // 如果报错的就是当前全局持有的客户端连接
    if(pxCurrentPCB == pxPCBClient)
    {
        pxPCBClient = NULL; // 核心操作:释放占位的无效指针,允许新连接接入
    }
}

2. 优化accept回调的前置校验逻辑,避免无效连接长期占用接入名额

原逻辑只要pxPCBClient非空就直接拒绝新连接,没有校验当前持有的PCB是否仍然有效,可以在原有的空指针判断分支前加一层有效性检查:

// 前置逻辑:判断pxPCBClient是否为NULL之前,先检查现有连接的状态
if(pxPCBClient != NULL)
{
    // 如果协议栈已经标记该PCB为关闭状态,说明连接已经失效
    if(pxPCBClient->state == CLOSED)
    {
        prvvMBPortReleaseClient(pxPCBClient);
        pxPCBClient = NULL;
    }
}

3. 增加新连接匹配校验,适配PC端动态端口重连的场景

针对你提到的PC端重连后会随机变更临时远程端口的现象,可以加一层快速校验:如果新接入的连接和当前持有客户端的IP、端口信息都不匹配,说明客户端已经断开旧连接发起新请求,主动释放旧占位连接:

if(pxPCBClient != NULL)
{
    // 对比新旧连接的IP和远程端口
    bool isSameClient = ip_addr_cmp(&pxPCBClient->remote_ip, &pxPCB->remote_ip) 
                        && pxPCBClient->remote_port == pxPCB->remote_port;
    if(!isSameClient)
    {
        // 新连接来自不同端口,说明旧连接已经失效,释放旧连接
        prvvMBPortReleaseClient(pxPCBClient);
        pxPCBClient = NULL;
    }
}

内容的提问来源于stack exchange,提问作者hobik

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 17:54:04