Soft WDT reset：看门狗复位：程序卡住太久
ESP8266 常见问题 · 排查从第 L3 层开始
日志里常见的字样
Soft WDT resetwdt resetrst cause:4这条报错说明什么
循环里有长时间不返回的代码（while 等待、长 delay、阻塞的网络请求），ESP8266 的 Wi-Fi 后台任务得不到运行，看门狗把芯片复位了。
先做这一步
在长循环里加 yield() 或 delay(0)；网络请求设置超时；不要在中断里做耗时操作。
按顺序排查，别跳步
- L0供电：核对供电与指示灯
- L1连接：确认 USB、驱动与端口
- L2烧录：检查模式、工具与配置
- L3最小程序：建立独立运行基线
断开外设，运行与板型匹配的 LED 或串口最小程序。 - L4串口：确认运行日志
- L5外设：逐个验证接线和通信
NodeMCU ESP8266 的注意事项
- GPIO 不耐受 5V；A0 经板上分压可测 0–3.3V（芯片引脚本身最高 1V）。
- D3(GPIO0)、D4(GPIO2)、D8(GPIO15) 决定启动模式，外设不能在上电时拉错电平。
- SD0–SD3、CMD、CLK 连接内部 Flash，不能当普通 IO 用。
- 板载 LED 在 D4(GPIO2)，低电平点亮。
相关问题
板伴 Boardly · 给硬件初学者的免费排错工具。内容依据公开资料整理，尚未逐条经过实物验证，请以实际测量为准。