MSWJS项目中Undici与Jest集成时的HTTP状态码范围错误解析

问题背景

在使用MSWJS(Mock Service Worker)与Jest测试框架集成时，开发者遇到了一个关于HTTP状态码范围的错误："RangeError: init["status"] must be in the range of 200 to 599, inclusive"。这个错误源于Node.js内置的Undici库对HTTP响应状态码的严格校验。

错误本质

Undici作为Node.js的HTTP/1.1客户端，强制要求所有HTTP响应状态码必须在200-599范围内。然而在实际开发场景中，特别是WebSocket通信和一些开发工具(如Console Ninja、Effect Devtools等)会使用101 Switching Protocols这样的状态码，这就导致了兼容性问题。

问题复现

通过分析开发者提供的复现仓库，可以确定问题触发条件：

1. 测试环境中使用了MSWJS进行API mocking
2. 同时运行了使用WebSocket的开发工具
3. Jest测试执行时，这些工具尝试建立WebSocket连接
4. WebSocket握手过程发送101状态码
5. Undici拒绝处理这个"非法"状态码，抛出RangeError

技术细节

在HTTP协议中：

• 101状态码用于协议升级，如从HTTP升级到WebSocket
• 1xx状态码属于信息性响应，而Undici只接受2xx-5xx的成功或错误响应
• MSWJS的拦截器在模拟响应时直接传递了原始状态码，没有做范围校验

解决方案

MSWJS团队在2.6.5版本中修复了这个问题，具体方案是：

1. 在MockHttpSocket拦截器中添加状态码校验逻辑
2. 对于小于200的状态码，自动转换为200
3. 保持原有2xx-5xx状态码不变
4. 确保WebSocket等特殊场景能正常工作

最佳实践

对于开发者来说：

1. 确保使用MSWJS最新版本(2.6.5+)
2. 检查测试环境中是否有使用WebSocket的开发工具
3. 如果必须使用这些工具，考虑在测试配置中暂时禁用它们
4. 不要手动修改node_modules中的代码，这会导致维护问题

总结

这个案例展示了测试工具链集成时可能遇到的底层协议限制问题。MSWJS团队通过合理的兼容性处理，既遵守了Undici的限制，又支持了WebSocket等特殊场景，为开发者提供了更稳定的测试体验。理解这类问题的根源有助于开发者更好地调试和解决类似集成问题。