NETCONN API的线程安全边界在于：每个netconn对象仅在其创建线程中调用netconn_new()、netconn_recv()等函数才安全，跨线程直接操作会触发断言或返回ERR_VAL；其线程安全依赖隐式绑定的创建线程上下文，而非全局tcpip_thread。
NETCONN API 的线程安全边界在哪
NETCONN API 本身不是线程安全的，netconn_new()、netconn_connect()、netconn_recv() 等函数只能在创建该 netconn 的线程中调用。LwIP 的默认配置（LWIP_NETCONN=1）下，它依赖于一个隐式的“NETCONN 线程”（通常叫 tcpip_thread），但这个线程**不负责执行你的业务逻辑**——它只调度 NETCONN 内部的同步操作（比如把 netconn_send() 转发给底层协议栈）。所以你不能把 netconn 句柄传给另一个线程然后直接调用 recv/send。
常见错误现象：netconn_recv() 返回 ERR_VAL 或阻塞不返回，或触发断言 LWIP_ASSERT("netconn is not in thread context", sys_thread_current() == netconn->thread)。
- 必须在
netconn创建线程中完成全部 I/O：要么在tcpip_thread里做（不推荐，会阻塞协议栈） - 要么自己起一个专用线程，并在该线程中调用
sys_thread_new()启动，再用netconn_new()创建连接 - 若需多线程协作，只能通过消息队列或信号量通知，不能跨线程直接操作
netconn对象
Socket API 在 LwIP 中怎么启用和使用
LwIP 的 Socket API 是基于 NETCONN 封装的，启用它需要同时打开两个宏：LWIP_SOCKET=1 和 LWIP_NETCONN=1（后者是前者依赖）。编译后你会得到标准的 socket()、connect()、send()、recv() 等函数，但它们内部仍走 NETCONN 路径，因此同样受线程约束。
关键差异在于：Socket API 默认将每个 socket 绑定到调用它的线程上下文。也就是说，你在某线程中调用 socket()，后续所有对该 socket 的 send()/recv() 必须在**同一个线程**，否则会返回 EBADF 或触发断言。
立即学习“C++免费学习笔记（深入）”；
-
select()在 LwIP 中支持有限：仅对本线程创建的 socket 有效，且需开启LWIP_SELECT=1 - 阻塞模式下，
recv()会挂起当前线程；非阻塞需设SOCK_NONBLOCK或用fcntl(fd, F_SETFL, O_NONBLOCK) - 不要混用
netconn和socket：同一连接不能一边用netconn_recv()，一边用recv()
写一个可运行的 TCP 客户端传输线程示例
以下是一个典型的裸机/RTOS 下的 TCP 客户端线程骨架（以 FreeRTOS 为例），使用 NETCONN API，避免侵入 tcpip_thread：
static void tcp_client_task(void *arg) {
struct netconn *conn;
struct netbuf *buf;
err_t err;
<p>conn = netconn_new(NETCONN_TCP);
if (!conn) { /<em> 失败处理 </em>/ }</p><p>err = netconn_connect(conn, &srv_addr, 8080);
if (err != ERR_OK) { /<em> 连接失败 </em>/ }</p><p>// 发送
netconn_write(conn, "GET / HTTP/1.1\r\nHost: example.com\r\n\r\n",
42, NETCONN_NOCOPY);</p><p>// 接收（带超时）
netconn_set_recvtimeout(conn, 5000); // ms
while ((err = netconn_recv(conn, &buf)) == ERR_OK) {
// 处理 buf->p 数据
netbuf_delete(buf);
}</p><p>netconn_close(conn);
netconn_delete(conn);
}</p>启动方式：sys_thread_new("tcp_cli", tcp_client_task, NULL, 2048, tskIDLE_PRIORITY + 2)。注意栈大小留足，因为 netconn 操作可能触发内存分配和协议栈回调。
- 务必检查每一步的
err_t返回值，LwIP 很少抛异常，全靠返回码判断 -
NETCONN_NOCOPY表示不拷贝数据，发送缓冲区必须在调用期间保持有效 - 接收循环中未处理
ERR_MEM或ERR_CLSD容易导致死循环或崩溃
为什么你的线程收不到数据或频繁断连
最常被忽略的是 LwIP 的内存管理配置。如果 MEMP_NUM_NETBUF 或 MEMP_NUM_NETCONN 设得太小，netconn_recv() 会立即返回 ERR_MEM，看起来像“没数据”，实则是拿不到接收缓冲区。同理，TCPIP_THREAD_STACKSIZE 不够会导致 tcpip_thread 自身卡住，进而让所有 NETCONN/SOCKET 操作变慢或失效。
- 查内存池：用
memp_stats_print(NULL)打印各池使用峰值，重点关注NETBUF和NETCONN - 确认
LWIP_TCPIP_CORE_LOCKING=1（推荐），否则多线程调用netconn时锁机制可能失效 - UDP 场景下，
netconn_bind()必须显式调用，否则netconn_recv()永远阻塞——TCP 则不需要 - RTOS 下，确保
sys_arch.c中的sys_sem_wait()和sys_mbox_fetch()实现正确，否则超时逻辑完全失效
线程模型本身不复杂，但 LwIP 把协议栈、内存、同步原语耦合得很紧，出问题时往往不是 API 用错了，而是底层资源或锁配置漏了一处。
