参考已知问题速查

已知问题速查

影响本站示例的 Bun 已知缺陷与限制，按核验日期排序并附一手 issue

最后更新于

如何使用本页

本页只收录会改变本站示例行为的缺陷与限制，不是 Bun issue 列表的镜像。每条都附一手 issue 链接；采取规避措施前先打开 issue 确认最新状态，已修复的条目会在下次复核时移除。

包管理与 CI

问题影响规避状态（2026-08-02）
bun audit --prod 在 monorepo 根目录过滤失效Workspace 根目录执行时仍报告 devDependencies 漏洞在目标仓库结构下实测输出，不要只看退出码开放
bun audit 不支持 --production / --omit=dev 写法从 npm 迁移的脚本直接失败改用 --prod开放
bun install --frozen-lockfile --production 在 Docker 构建中异常缓慢镜像构建耗时大幅增加分层缓存安装阶段；关注 issue 的修复版本开放
bun update 生成的锁文件导致下一次 --frozen-lockfile 失败更新依赖后 CI 冻结安装报错更新后本地再跑一次 bun install 并提交锁文件issue 已关闭（重复）；修复 PR #31752 仍开放

测试运行器

问题影响规避状态（2026-08-02）
1.3.13 的 --isolate / --parallel 与原生 NAPI 扩展共同使用时崩溃加载原生扩展的测试套件段错误升级到 1.3.14 或更高已在 1.3.14 修复
--isolate 在动态 import 顶层 await 模块时失败（1.3.14 回归）使用 TLA 动态导入的测试文件报错受影响套件暂时串行运行，关注修复版本开放

Redis 客户端

问题影响规避状态（2026-08-02）
用 HELLO 2 降级到 RESP2 后 subscribe() 静默丢消息订阅连接不再收到推送且无报错不要降级协议；保持 RESP3（Redis 7.2+）开放
大 EVAL 请求期间重连后 send() 永久挂起连接恢复后请求不再返回为 send() 调用包一层应用级超时开放

使用约定

  • “状态”列是核验日快照，不是当前真实状态；issue 页面永远更新。
  • 未列出不代表不存在：生产采用前按 生产工程基线 做目标环境验证。
  • 发现新缺陷时，先用最小复现确认与 Bun 版本的因果关系，再决定是否记录到这里。

官方参考：oven-sh/bun issues、Bun releases。

常见报错对照

Bun 高频错误信息的原因与处理路径，按发生阶段分组

性能测量方法论

用可复现的方法评估 Bun 的启动、吞吐与内存，不被微基准误导