使用ClientWebSocket类接收消息时报帧保留位设置异常如何解决？

你遇到的报错本质是第三方WebSocket服务端开启了permessage-deflate帧压缩扩展，压缩后的帧会占用WebSocket帧头的RSV1预留位标识压缩状态。默认配置下的ClientWebSocket未启用对应的压缩扩展，会直接将预留位被置为1的帧判定为非法帧，抛出对应异常。
小消息可以正常接收是因为绝大多数服务端都会配置压缩阈值，小于阈值的消息不会触发压缩，预留位保持默认0值，因此不会触发校验错误。

方案1：客户端开启permessage-deflate压缩扩展（推荐） #

仅需在ClientWebSocket实例初始化后、调用ConnectAsync前，添加压缩扩展配置即可，原有消息接收逻辑无需修改，ReceiveAsync会自动完成帧解压缩操作，代码示例如下：

var client = new ClientWebSocket();
// 配置permessage-deflate压缩扩展，参数需和服务端配置保持一致
client.Options.DangerousDeflateOptions = new WebSocketDeflateOptions
{
    ClientContextTakeover = true,
    ServerContextTakeover = true,
    ClientMaxWindowBits = 15,
    ServerMaxWindowBits = 15
};
// 后续正常执行连接逻辑
await client.ConnectAsync(new Uri("第三方WebSocket服务端地址"), CancellationToken.None);

注意：DangerousDeflateOptions 是.NET Core 3.0、.NET 5及以上版本才支持的API，若使用更低版本的.NET框架，可以改用支持压缩扩展的第三方WebSocket库实现。

方案2：协商服务端关闭压缩 #

若无法修改客户端配置，可以联系第三方服务端提供方，关闭针对你客户端的permessage-deflate压缩扩展，服务端返回的帧不会再设置预留位，即可兼容原有客户端逻辑。该方案会增大消息传输的带宽占用，仅作为临时备选方案。

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