Node serialport二次写入COM端口报Invalid handle错误求解决方案

• 重复调用端口资源释放接口：port.destroy()和port.close()都是异步释放串口资源的操作，同时调用会导致资源释放逻辑冲突，端口句柄提前被标记为无效，但系统层的串口资源还未完全释放，下一次初始化端口时会抢不到有效句柄，等到第三次操作时前一次的残留资源刚好被系统回收，就又能正常执行，形成奇偶次循环异常。
• 未等待异步操作完成就释放资源：port.write()、port.drain()都是异步方法，没有等待写操作、数据接收逻辑完全结束就提前销毁流，导致第二次写入时流已经被标记为销毁状态，抛出ERR_STREAM_DESTROYED错误。
• 未判断前一次端口释放状态就初始化新实例：每次事务直接新建SerialPort实例，若上一次的端口还在异步关闭过程中，新实例拿到的就是无效句柄。

1. 移除重复的资源释放操作 #

不要同时调用destroy()和close()，serialport@9+版本中port.close()本身就会处理流的销毁和资源释放，仅保留这一个接口即可，且要放在所有异步操作完成之后调用。

2. 串行化所有端口操作，等待异步逻辑完成再释放资源 #

可以用Promise封装整个读写事务，确保写、drain、接收响应全部完成后再关闭端口，参考代码如下：

// 封装单事务读写为Promise
function writeEdc(data, serialPortConfig, baudRateConfig) {
  return new Promise((resolve, reject) => {
    const port = new SerialPort(serialPortConfig, { 
      baudRate: parseInt(baudRateConfig),
      autoOpen: false // 关闭自动打开，手动控制打开时机
    }).setEncoding('hex');
    const parser = new Readline();

    // 全局错误监听
    port.on('error', (err) => {
      reject(err);
      // 出错时先清理资源
      if(port.isOpen) {
        port.close(() => {});
      }
    });

    // 端口打开成功后再执行读写
    port.open((openErr) => {
      if(openErr) return reject(openErr);
      port.pipe(parser);

      port.write(data, (writeErr) => {
        if(writeErr) {
          port.close(() => reject(writeErr));
        }
      });

      port.drain((drainErr) => {
        if(drainErr) {
          return port.close(() => reject(drainErr));
        }
        // drain完成后监听一次返回就关闭端口，避免重复绑定事件
        port.once('data', (resData) => {
          console.log('[response]:', resData);
          port.unpipe(parser);
          // 确认端口处于打开状态再执行关闭
          if(port.isOpen) {
            port.close((closeErr) => {
              if(closeErr) return reject(closeErr);
              resolve(resData);
            });
          } else {
            resolve(resData);
          }
        });
      });
    });
  });
}

// 事务调用时串行执行，不要并行触发多次读写
async function runTransaction(writeData) {
  try {
    const res = await writeEdc(writeData, '你的串口号', 你的波特率);
    // 处理返回结果
  } catch (err) {
    console.error('事务执行出错:', err);
  }
}

3. 新增端口状态校验 #

每次新建端口实例前，先判断当前是否有正在打开/关闭的端口实例，也可以调用SerialPort.list()确认目标串口没有被占用后再初始化。

4. 可选优化：复用端口实例 #

如果事务调用非常频繁，建议保持端口长连接，不需要每次事务都开关端口，仅在程序退出时关闭端口，可完全避免频繁开关端口导致的资源释放异常问题。

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