libwebsockets中HTTP1.1连接的错误日志分析

在libwebsockets项目中，当使用SSE(Server-Sent Events)示例代码时，开发者可能会遇到一个特定的错误日志："E: [wsisrv|1|adopted]: lws_mux_mark_immortal: not mux substream"。这个错误日志出现在HTTP1.1连接建立时，但在HTTP2连接中则不会出现。

错误日志的背景

这个错误日志来源于libwebsockets内部的一个API函数lws_mux_mark_immortal。该函数主要有两个职责：

1. 移除任何超时设置
2. 如果是HTTP2多路复用(mux)流，则执行一些额外的内部管理操作

问题原因分析

在HTTP1.1连接的情况下，由于HTTP1.1协议本身不支持多路复用，因此当调用lws_mux_mark_immortal函数时，函数检测到当前连接不是HTTP2的多路复用子流，就会输出这条错误日志。但实际上，这个错误日志并不表示真正的功能性问题，因为：

1. 对于HTTP1.1连接，函数已经完成了其主要职责（移除超时设置）
2. 多路复用相关的额外操作本来就是针对HTTP2的，在HTTP1.1中不需要执行

解决方案

libwebsockets开发团队已经意识到这个问题，并在v4.3-stable和main分支中移除了这条错误日志。这表明：

1. 这个日志原本就不应该被归类为错误级别
2. 它实际上只是一个内部实现细节的提示，不影响功能
3. 对于开发者来说，可以安全地忽略这个日志

技术启示

这个案例展示了协议差异在底层实现中的体现：

1. HTTP1.1和HTTP2在连接管理上的根本区别（单流vs多路复用）
2. 库函数需要同时处理多种协议时的实现考量
3. 错误日志分类的重要性，避免误导开发者

对于使用libwebsockets的开发者来说，理解这些底层细节有助于更好地诊断和解决实际问题，同时也能更深入地理解不同HTTP协议版本在实现上的差异。