网页串口断开后再也连不上:怎样定位未释放的读写锁
网页串口断开后再也连不上,常见原因是 UI 已显示“断开”,底层读取循环还在等待,或者 writer 被长期保存。Web Serial 的关闭条件是读写流均已解锁。应围绕一个连接对象完成生命周期,再谈 USB 拔插后的自动恢复。
先区分设备消失与资源未释放
把错误原文、readable.locked、writable.locked 与会话编号写进日志。设备仍在且 close 失败,优先查锁;物理拔出后 readable 出错,则是设备断开事件,两者需要不同清理路径。不要让下一次连接直接覆盖旧 port 变量,否则旧 reader 的归属会丢失。
下面例子不使用 TextDecoderStream,减少管道关闭的干扰。下载完整生命周期示例,通过 localhost 静态服务在支持 Web Serial 的桌面浏览器打开。选择设备需要按钮触发,波特率仍须按设备手册改。它只打印原始字节,不含自动重连与设备协议。
let port, reader, reading;
let stopping = false;
async function readLoop() {
reader = port.readable.getReader();
try {
while (!stopping) {
const {value, done} = await reader.read();
if (done) break;
console.log([...value]);
}
} catch (error) {
console.error(error);
} finally {
reader.releaseLock();
reader = undefined;
}
}
async function disconnect() {
stopping = true;
if (reader) await reader.cancel();
await reading;
await port.close();
port = undefined;
}
例子特意让读循环自己在 finally 释放锁。不要一边 read 尚未结束,一边从按钮回调强行 releaseLock。reader.cancel 让等待中的读取有机会结束;随后等待 reading,才能确定 finally 已经运行。若取消时设备已拔出,取消本身也可能失败,完整附件保留错误并继续等待清理任务。
写入也必须有自己的结束点
每次发送临时取得 writer,把 getWriter 本身也放进 try,再在 finally 中释放已取得的锁。设备拔出时 writable 可能已不可用,获取锁也可能抛错;不能让写队列永久停在拒绝状态。发送过程中点击断开时,需要等待当前发送任务结束,不能简单禁用按钮后立即 close。完整附件维护 pendingWrite,并在断开时先禁止新发送、等待已有写入,再取消读取。
完整示例会逐项记录写入、取消、读循环和关闭错误。关闭失败时保留旧会话、禁用新发送并允许再次断开;只有 close 完成后才重新允许连接,避免为了恢复按钮而丢掉尚未清理的端口对象。
如果你采用编码变换流,reader 上的锁和底层 port.readable 的管道锁不是一回事。需要保存 pipeTo 返回的 Promise,按 Chrome 文档等待管道收束,再关闭端口。把无变换流样例中的几个调用直接复制到带编码管道的工程里,并不自动正确。
用四轮验收暴露遗漏
第一轮连接后不发送,立即断开;第二轮发送一个无害字节串后断开;第三轮连续执行三次连接、断开,检查每轮没有遗留锁;第四轮连接中物理拔出,再插回后重新选择目标。最后一轮涉及设备条件,未接真机时保持“待验收”。
每轮至少记会话号、打开完成、发送完成、取消完成、读循环退出、close 完成六类事件。事件顺序能指出问题:若没有读循环退出,就是读取任务没有结束;若退出但写流仍 locked,查 writer 的 finally;若均解锁仍 open 失败,再查外部占用。
常见问题
刷新页面是不是修复了锁? 页面销毁可能使资源释放,但它没有修好应用的关闭路径,应以正常断开后重连验收。
releaseLock 会关闭串口吗? 不会,它只是放开流的 reader 或 writer,端口关闭仍要调用 close。
能自动重连最后一块板吗? 可以另行设计,但要确认设备身份、授权与旧任务结束。本文先验收单会话资源释放,避免重连计时器放大故障。
来源与配套记录
下载本文样例或空白记录(N045.json)。附件的 kind 明确区分合成数据与待填写记录,空值不是实测结果。
本文依据官方文档与自建合成样例整理,未连接真实设备完成现场测试;计算结果以附件脚本输出为准。核对日期:2026-10-23。
操作入口见串口调试助手网页版;继续处理相关任务可看网页串口提示端口被占用,怎样查出是谁还开着它。
本文为公开资料整理,非亲测。关键参数与代码请结合实物与下列官方来源验证。
- Chrome Web Serial:读写、关闭和控制信号 ↗
developer.chrome.com/docs/capabilities/serial