Hono.js代理功能中Response状态码丢失问题分析

Hono.js是一个轻量级的Web框架，最近在它的代理功能中发现了一个值得注意的问题：当使用hono/proxy模块进行请求代理时，原始响应的状态码(status)没有被正确保留。这个问题会影响开发者对代理请求结果的判断和处理。

问题现象

在Hono.js的代理实现中，当转发请求并返回响应时，虽然响应体(body)和头部(headers)都被正确传递，但原始响应的HTTP状态码却被意外丢弃了。这意味着即使后端服务返回了如404或500等错误状态码，代理响应仍然会显示为默认的200状态。

技术分析

问题的根源在于代理函数的实现方式。原始代码直接将响应对象展开到新的Response构造函数中，但这种方式可能不会完整保留所有响应属性。正确的做法应该是显式地设置状态码和状态文本。

以下是修复前后的代码对比：

修复前：

return new Response(res.body, {
  ...res,  // 这种展开方式不能保证状态码被正确传递
  headers: resHeaders,
})

修复后：

return new Response(res.body, {
  status: res.status,       // 显式设置状态码
  statusText: res.statusText, // 显式设置状态文本
  headers: resHeaders,
})

影响范围

这个问题在多种环境下都会出现：

1. Node.js环境
2. 使用undici作为HTTP客户端时
3. Miniflare本地开发环境
4. 实际部署到云服务商Workers时

解决方案

开发团队已经确认了这个问题并提供了修复方案。新版本将确保代理响应正确保留原始响应的状态码和状态文本，使开发者能够根据正确的HTTP状态进行后续处理。

最佳实践

在使用代理功能时，开发者应该：

1. 始终检查响应的状态码，而不仅仅是响应体
2. 针对不同的状态码实现适当的错误处理逻辑
3. 考虑在代理层添加状态码的日志记录，便于调试
4. 更新到包含此修复的Hono.js版本

这个问题提醒我们，在使用JavaScript的对象展开运算符(...)时，需要特别注意哪些属性会被实际复制，特别是当处理像Response这样的复杂对象时。显式设置关键属性往往是更可靠的做法。