Raspberry Pi Pico W启动Wi-Fi时子线程挂起问题排查

问题根源 #

1. MicroPython线程的硬件资源限制：Pico W的MicroPython对硬件外设（比如Wi-Fi模块）的操作有严格线程限制，wlan.active(True)这类初始化操作必须在主线程执行。子线程没有权限或无法正确触发Wi-Fi模块的硬件初始化流程，执行到这一步就会阻塞或直接终止。
2. 网络栈的线程安全性问题：MicroPython的网络栈实现并非完全线程安全，子线程尝试初始化网络接口时，会和主线程的系统资源管理产生冲突，导致线程挂起。

解决办法 #

方案一：主线程完成Wi-Fi初始化，子线程只跑Web服务逻辑 #

把Wi-Fi激活、连接的步骤全部放在主线程完成，子线程仅负责处理HTTP请求和设备控制逻辑，避开线程权限问题。示例代码如下：

import network
import _thread
import time
import socket

# 主线程初始化Wi-Fi
wlan = network.WLAN(network.STA_IF)
wlan.active(True)
wlan.connect("你的WiFi名称", "你的WiFi密码")

# 等待Wi-Fi连接完成
while not wlan.isconnected():
    print("正在连接Wi-Fi...")
    time.sleep(0.5)
print(f"Wi-Fi已连接，IP地址: {wlan.ifconfig()[0]}")

def webServerMain():
    # Web服务器核心逻辑
    addr = socket.getaddrinfo('0.0.0.0', 80)[0][-1]
    s = socket.socket()
    s.bind(addr)
    s.listen(1)
    print("Web服务器已启动，等待连接...")

    while True:
        conn, addr = s.accept()
        print(f"来自 {addr} 的连接")
        request = conn.recv(1024)
        # 处理请求、控制LED等逻辑
        response = "HTTP/1.1 200 OK\r\nContent-Type: text/html\r\n\r\n<html><body>LED控制页面</body></html>"
        conn.send(response)
        conn.close()

# 启动Web服务子线程
_thread.start_new_thread(webServerMain, ())

# 主线程计数逻辑
count = 0
while True:
    print(f"计数: {count}")
    count += 1
    time.sleep(1)

方案二：改用非阻塞式单线程实现 #

如果不想用线程，可在主线程中用select模块实现非阻塞Web服务器，同时处理计数任务，完全避免线程冲突。示例思路如下：

import network
import time
import socket
import select

# 主线程初始化Wi-Fi
wlan = network.WLAN(network.STA_IF)
wlan.active(True)
wlan.connect("你的WiFi名称", "你的WiFi密码")
while not wlan.isconnected():
    time.sleep(0.5)

# 初始化socket并设为非阻塞模式
addr = socket.getaddrinfo('0.0.0.0', 80)[0][-1]
s = socket.socket()
s.bind(addr)
s.listen(1)
s.setblocking(False)

count = 0
while True:
    # 用select检查是否有客户端连接
    read_sockets, _, _ = select.select([s], [], [], 0.1)
    if read_sockets:
        conn, addr = s.accept()
        conn.setblocking(False)
        # 处理请求逻辑
        conn.close()
    
    # 执行计数逻辑
    print(f"计数: {count}")
    count += 1
    time.sleep(1)

验证步骤 #

1. 在子线程的wlan.active(True)前后添加print("准备激活Wi-Fi")和print("Wi-Fi已激活")，确认子线程确实卡在激活步骤。
2. 把Wi-Fi初始化代码移到主线程，重新运行，观察子线程是否能正常启动Web服务器。

内容的提问来源于stack exchange，提问作者David P