Undici WebSocket 连接错误时未触发关闭事件问题分析

问题背景

在Node.js生态中，Undici作为一款高性能的HTTP/1.1客户端库，其WebSocket实现被广泛使用。近期发现一个值得关注的行为差异：当WebSocket连接因错误而终止时，Undici的WebSocket实现未能正确触发close事件，这与浏览器标准行为存在不一致。

问题现象

当尝试连接一个不存在的WebSocket端点时，Undici的WebSocket客户端仅触发了error事件，而浏览器环境下的WebSocket实现则会依次触发error和close两个事件。这种差异可能导致依赖close事件进行资源清理的应用程序出现内存泄漏或其他异常行为。

技术分析

根据WebSocket规范，任何导致连接终止的情况（包括错误）都应该最终触发close事件。这是WebSocket生命周期管理的重要环节，确保开发者有统一的处理点来进行连接终止后的清理工作。

Undici在v6版本中存在以下关键问题：

1. 错误处理流程中遗漏了连接状态更新
2. 未正确执行连接关闭的完整生命周期
3. readyState状态未按规范更新为CLOSED(3)

解决方案

该问题已在Undici的v7版本中通过重构WebSocket实现得到修复。主要改进包括：

1. 完善了错误处理流程，确保错误导致的连接终止会触发close事件
2. 严格遵循WebSocket规范的状态转换机制
3. 保证readyState在连接关闭后正确更新为CLOSED(3)

版本兼容性说明

由于v6版本的WebSocket实现架构限制，该修复无法直接向后移植。建议开发者考虑以下方案：

1. 升级到Node.js v22+环境，使用Undici v7
2. 在必须使用v6版本的情况下，自行实现错误处理中的close事件触发
3. 在应用层添加额外的连接状态监控逻辑

最佳实践建议

针对WebSocket连接管理，建议开发者：

1. 同时监听error和close事件，确保异常情况下的资源释放
2. 实现重连机制时，检查readyState状态
3. 在连接终止后进行必要的清理工作，无论终止原因是什么
4. 考虑使用封装库来处理这些边缘情况，提高代码健壮性

通过理解这个问题及其解决方案，开发者可以更好地构建可靠的WebSocket应用，避免因连接管理不当导致的各类问题。