Websockets项目升级指南：关于connection.close_code的注意事项

在Websockets项目从旧版本升级到新版本的过程中，开发者需要注意一个重要变化：原先通过connection.close_code和connection.close_reason属性获取WebSocket关闭状态的方式已经发生了变化。

根据WebSocket协议规范，关闭代码和原因应该从接收到的第一个关闭帧中获取，这代表了远程连接端的视角。在旧版实现中，这些信息直接通过连接对象的属性暴露给开发者。但在新版设计中，项目维护者认为这种设计违反了最小意外原则，因为大多数开发者实际上需要的是从自身视角出发的连接状态信息。

在新版本中，推荐的做法是通过捕获ConnectionClosed异常来获取关闭状态信息。这个异常对象包含了完整的连接关闭详情，更符合大多数使用场景的需求。但对于测试代码等特殊场景，开发者仍然可以通过访问connection.protocol.close_code来获取原始的关闭状态信息，虽然这是一个私有API，但其稳定性有保障。

对于需要保持向后兼容性的项目，开发者可以考虑以下方案：

1. 直接使用connection.protocol访问底层协议状态
2. 在代码中添加版本判断，针对不同版本采用不同的属性访问方式
3. 在注释中明确标注未来升级路径

这个变化体现了Websockets项目在API设计上对开发者体验的持续优化，通过更合理的异常处理机制来提供连接状态信息，同时保留了必要的底层访问途径以满足特殊需求。开发者在升级时应该根据实际使用场景选择合适的迁移策略。