移动端 WebSocket 协议升级为何失败？检查 Upgrade 头部配置
移动端 WebSocket 连接升级失败时，应重点排查 Upgrade 和 Connection 头部是否被正确发送。
确认 Upgrade 头部是否被浏览器自动添加
WebSocket 协议升级机制要求客户端在 HTTP 请求中包含 Upgrade 和 Connection 头部。Upgrade 头部用于邀请服务器切换到 WebSocket 协议，而 Connection 头部则表明这些头部是逐跳传输的。如果客户端代码未正确触发升级，或者浏览器未自动添加这些头部，服务器将无法识别升级意图，导致连接失败。
检查步骤要求在移动端调试工具中定位到 WebSocket 的初始 HTTP 请求。确认是否存在 Upgrade: websocket 头部以及 Connection: upgrade 头部。如果这两个头部缺失，说明浏览器未自动处理升级过程，可能是由于使用了非标准的 WebSocket API 或底层 HTTP 请求方法。确保客户端代码仅调用标准的 WebSocket 构造函数，而非底层 HTTP 请求方法，以避免手动干预头部配置。
验证头部值是否符合协议规范
Upgrade 头部的值必须明确指定要升级的协议，例如 websocket。Connection 头部的值必须包含 upgrade 关键字。如果头部值拼写错误或格式不符合规范，服务器将忽略 Upgrade 头部并返回常规响应，而非 101 Switching Protocols 状态码。这会导致 WebSocket 连接无法建立。
验证方法包括检查头部值的拼写和格式。确保 Upgrade 头部的值为 websocket，Connection 头部的值为 upgrade。如果头部值被错误地设置为其他协议名称或缺少关键字，服务器将无法完成协议升级。确保客户端在调用 WebSocket 构造函数时，浏览器能够正确生成并附加这些头部。
检查是否手动覆盖了浏览器默认行为
浏览器在处理 WebSocket 升级时，会自动管理 Upgrade 和 Connection 头部。如果开发者试图通过底层 HTTP 请求方法手动设置这些头部，可能会干扰浏览器的默认行为。例如，使用 fetch API 发起请求时，手动添加 Upgrade 头部可能导致头部被忽略，从而引发连接失败。因此，应避免在 WebSocket 升级过程中手动干预这些头部。
排查时需确认客户端代码是否使用了非标准的 WebSocket API。如果使用了底层 HTTP 请求方法，应检查是否错误地设置了 Upgrade 或 Connection 头部。正确的做法是使用标准的 WebSocket 构造函数，让浏览器自动处理头部配置。确保代码逻辑不与浏览器的自动处理机制冲突。
确认服务器响应中的验证逻辑
服务器在收到包含 Upgrade 和 Connection 头部的请求后，会根据规范返回 101 Switching Protocols 响应状态码。该响应头部会指定协议升级后的新协议。如果服务器未正确验证这些头部，可能导致连接升级失败。因此，应确保服务器逻辑与 WebSocket 协议规范一致，能够正确处理浏览器自动生成的头部值。
验证结果的方法是检查服务器的响应状态码和头部。如果服务器返回 101 Switching Protocols，说明握手成功。如果返回 426 Upgrade Required 或其他错误状态码，可能是服务器未正确验证 Upgrade 头部。确保服务器逻辑与 WebSocket 协议规范一致，能够正确处理浏览器自动生成的头部值。
资料与延伸阅读
你可以通过以下原始资料核对文中概念，并继续深入阅读。