Bun 1.2.6+版本中express.json()挂起问题分析与解决方案

问题背景

Bun是一个新兴的JavaScript运行时环境，旨在提供比Node.js更快的性能。在Bun 1.2.6及更高版本中，用户报告了一个与Express框架相关的重要问题：当处理POST请求时，express.json()中间件会出现挂起现象。

问题表现

具体表现为：

1. 使用Express框架构建的Web服务器在处理POST请求时卡在express.json()中间件处
2. GET请求可以正常处理
3. 在中间件前后添加日志，只有"before"日志会被输出
4. 有时会伴随"error: Stream is already ended"的错误信息

影响范围

该问题出现在：

• Bun 1.2.6及以上版本（包括1.2.7）
• 不影响Bun 1.2.5及更早版本
• 在Windows和基于Debian的Docker环境中均能复现

技术分析

从错误信息来看，问题可能出在HTTP流的处理上。当请求被中止时，系统尝试向已经结束的流写入数据，导致"ERR_STREAM_ALREADY_FINISHED"错误。这通常表明在请求处理过程中出现了异步时序问题。

express.json()中间件底层使用raw-body模块来解析请求体，而错误堆栈显示问题发生在raw-body模块尝试处理被中止的请求时。这可能是由于Bun运行时在某些情况下过早地关闭了请求流。

解决方案

Bun团队已经确认该问题，并建议用户：

1. 立即解决方案：使用bun upgrade --canary命令升级到最新的canary版本
2. 长期解决方案：等待Bun 1.2.8正式发布后升级

验证结果

根据用户反馈，使用canary版本后问题已解决。建议用户在Bun 1.2.8正式发布后再次验证确认。

开发者建议

对于遇到类似问题的开发者：

1. 首先确认Bun版本是否在受影响范围内
2. 检查错误日志中是否有"ERR_STREAM_ALREADY_FINISHED"相关错误
3. 考虑暂时降级到Bun 1.2.5版本
4. 关注Bun官方更新，及时升级到修复版本

这个问题提醒我们，在使用新兴运行时环境时，保持对版本更新的关注非常重要，特别是当项目依赖特定功能或修复时。