Sing-box项目中WebSocket连接关闭错误的分析与解决

问题现象

在使用Sing-box项目时，用户报告了一个关于WebSocket连接的问题。具体表现为：

1. 当客户端使用某种WebSocket协议时，日志中频繁出现错误信息："ERROR connection: connection download closed: ws closed: 1000"
2. 当服务端降级到1.10.7版本后，客户端错误消失，但服务端开始出现类似错误："ERROR inbound/[protocol][1]: process connection from [IP]:[PORT]: upload: ws closed: 1000"

技术背景

WebSocket协议定义了一系列状态码，其中1000表示正常关闭连接。这是一个标准的状态码，表示连接已按预期完成。然而，在Sing-box项目中，这种正常的关闭操作被记录为错误级别(ERROR)的日志，这可能会误导用户认为出现了严重问题。

问题分析

1. 日志级别不当：WebSocket 1000状态码是正常关闭，不应记录为ERROR级别
2. 版本兼容性问题：不同版本的Sing-box对WebSocket关闭的处理方式不同
   • 较新版本(1.11.1)在客户端记录错误
   • 1.10.7版本在服务端记录错误
3. 多路复用问题：用户报告称新版本在多协议+TLS+reality配置下存在并发连接问题

解决方案

1. 日志级别调整：建议将WebSocket正常关闭(1000)的日志级别从ERROR调整为INFO或DEBUG
2. 版本选择：
   • 目前1.10.7版本表现相对稳定
   • 等待官方修复新版本中的并发连接问题
3. 配置优化：检查WebSocket相关配置，特别是：
   • max_early_data设置
   • early_data_header_name配置
   • 多路复用(multiplex)参数

最佳实践建议

1. 对于生产环境，目前建议使用经过验证的1.10.7版本
2. 监控WebSocket连接关闭频率，如异常频繁可考虑：
   • 调整keepalive设置
   • 检查网络稳定性
   • 验证TLS配置
3. 关注项目更新，等待官方修复日志级别和并发连接问题

总结

Sing-box项目中WebSocket连接关闭的错误日志实际上反映了两个不同的问题：一是日志级别设置不当，将正常关闭记录为错误；二是新版本中可能存在的并发连接处理问题。用户可根据实际需求选择稳定版本或等待官方修复。同时，理解WebSocket 1000状态码的正常性有助于正确解读日志信息。