Vite 6.0.0 版本中HTTP/2支持失效问题分析与解决方案

在Vite 6.0.0-beta.10版本及后续稳定版中，开发人员发现了一个重要的功能回归问题：当使用server.https配置时，HTTP/2支持意外失效，导致所有资源都降级为HTTP/1.1协议传输。这个问题在复杂的项目中尤为明显，会影响模块加载速度，并破坏依赖于HTTP/2流式传输的自定义开发服务器反向代理插件功能。

问题背景

HTTP/2是HTTP协议的第二个主要版本，相比HTTP/1.1有多项重大改进：

• 多路复用：允许同时通过单一的TCP连接发起多个请求和响应
• 二进制分帧：采用二进制格式传输数据而非文本
• 首部压缩：减少头部信息传输量
• 服务器推送：服务器可以主动向客户端推送资源

Vite作为现代前端构建工具，默认在HTTPS模式下启用HTTP/2以提升开发服务器的性能。但在6.0.0-beta.10版本中，这一功能出现了意外退化。

问题表现

开发人员可以通过以下方式验证问题：

1. 配置Vite使用自签名证书
2. 启动开发服务器
3. 通过浏览器开发者工具检查网络请求协议

在正常情况（Vite 5或6.0.0-beta.9）下，资源应通过h2（HTTP/2）协议传输；而在受影响版本中，所有资源都降级为HTTP/1.1协议。

根本原因

经过代码分析，问题源于Vite 6.0.0-beta.10中引入的一个变更。在创建服务器时，默认的proxy配置被设置为空对象而非undefined。这个细微差别导致了HTTP/2支持被意外禁用。

在Node.js的http/https服务器实现中，当proxy被显式设置为对象（即使是空对象）时，会被视为有意配置代理，从而影响底层服务器的创建方式，导致HTTP/2支持被禁用。

解决方案

Vite团队在6.0.1版本中修复了这个问题，具体做法是：

• 将默认的proxy配置恢复为undefined而非空对象
• 确保只有在实际配置了代理时才影响服务器创建逻辑

最佳实践

对于需要使用HTTPS和HTTP/2的开发场景，建议：

1. 确保使用Vite 6.0.1或更高版本
2. 验证开发服务器的协议支持情况
3. 对于自定义服务器配置，仔细检查可能影响底层协议选择的选项

总结

这个案例展示了配置默认值的重要性，即使是看似无害的空对象也可能导致意外的功能退化。Vite团队快速响应并修复了这个问题，确保了开发体验的连贯性和性能表现。对于开发者而言，及时更新到修复版本是解决此类问题的最佳方案。