排查顺序

| 现象 | 核对与处理 |

| --- | --- |

| 网址连接被拒绝 | 127.0.0.1 只指向当前电脑，先完整解压并双击启动平台；无需因此重新烧录。查看 data/service.log。关闭浏览器不会关闭服务，可在平台“关闭本机平台”。 |

| 提示14605占用 | 先关闭原作者平台或另一份成员平台。不能用公网统一入口代替本机服务，也不要结束不明进程。技术人员可用启动脚本的 --port 参数选择另一端口。 |

| 无 CH343 串口 | 检查 USB 数据线是否能传数据、板型号、USB插口和设备管理器。驱动只在必要时由用户运行 WCH 原包，平台不安装或提权。匹配 VID1A86/PID55D3。 |

| 串口打开失败 | 关闭 VS Code 串口监视器、其他串口工具和其他平台设备会话；检查拔插后 COM 号是否改变。配置、烧录和收发共用设备锁。 |

| 旧固件 | 先核对同型号4MB板，再确认烧录本包固定镜像。工具成功不等于当前启动/联网成功，需重新检查。不要自行添加 erase_flash/擦除 NVS。 |

| 配网超时 | 2.4G仅满足频段条件，还需名称、密码、WPA2个人模式、信号与热点允许设备接入正确。超时不能直接判断密码错误；板端 wifi_reason 是底层断开原因，用于诊断而非平台猜测。检查后重新准备一次操作。 |

| 电脑地址不属于当前网卡 | 电脑连接目标热点后刷新 IPv4 候选。不要沿用作者固定IP；VPN、虚拟网卡等候选可能不是热点地址，需要自己选择。 |

| 已入网却收不到 Wi-Fi 密文 | 核对电脑和板端同一热点、接收IP仍有效、UDP3345可用。确认手机没有启用客户端隔离。必要时由成员按学校/系统规则手动允许本程序的 UDP3345 入站，平台不会关闭防火墙、申请管理员权限或修改网络设置。 |

| 配对文件缺失或解密失败 | 当前 Windows 用户/电脑与保存者不同、data遗失、板在另一电脑重新配对都会造成该问题。恢复本用户对应 data 备份，或明确重新配对。不要复制作者密钥或自动切换到标识9。 |

| 配对时 USB中断 | 检查设备，若指纹与本电脑加密草稿匹配可恢复提交；否则保存失败记录，再明确准备重新配对。不自动重试。 |

| 认证失败 | 不显示未认证明文，记录为会话诊断。可能是报文受损、来源错误或配对不匹配；无法可靠关联的异常不会记到某条消息上。 |

| 原文不一致 | 按原始 UTF-8 字节比较，空格、换行、组合Unicode字符也可能不同；不发送成功 ACK，后续超时不覆盖不一致原因。 |

| 缺少板端 ACK | 电脑认证解密不等于板端最终确认。保存CSV与诊断，检查回程UDP、连接与热点状态，不自动重发。 |

| 更新下载/校验失败 | 核对Cloudflare入口和latest.json网络响应。v3使用明确平台下载标识；保留错误，SHA不符时停止，旧程序与数据仍保留。旧v1/v2失效渠道和旧客户端不能当已验更新。 |

| Pages返回404或403 | 确认使用esp32-member-platform.pages.dev及当前发布文件夹；403/1010是客户端特征拦截，不能关闭安全设置、冒充浏览器或当下载通过。此前GitHub匿名404及Actions422失败保留。 |

来源：WCH CH343官方页面 https://www.wch.cn/downloads/CH343SER_EXE.html；ESP-IDF5.5.4 Wi-Fi https://docs.espressif.com/projects/esp-idf/en/v5.5.4/esp32c3/api-reference/network/esp_wifi.html；DPAPI https://learn.microsoft.com/en-us/windows/win32/api/dpapi/nf-dpapi-cryptprotectdata；NIST GCM https://csrc.nist.gov/pubs/sp/800/38/d/final。