Bun DocsReferenceKnown issues
Known issues
Bun defects and limitations that affect this site's examples, with first-party issue links and review dates
Last updated on
How to use this page
This page only tracks defects and limitations that change the behavior of examples on this site — it is not a mirror of the Bun issue tracker. Every entry links to the first-party issue; check the issue before applying a workaround, and fixed entries are removed at the next review.
Package management and CI
| Issue | Impact | Workaround | Status (2026-08-02) |
|---|---|---|---|
bun audit --prod filtering broken at monorepo roots | devDependency vulnerabilities still reported from the workspace root | Test the output in your actual repo layout; don't trust the exit code alone | Open |
bun audit does not accept --production / --omit=dev | Scripts migrated from npm fail outright | Use --prod instead | Open |
bun install --frozen-lockfile --production unusually slow in Docker builds | Image build times balloon | Cache the install stage in its own layer; watch the issue for the fix | Open |
bun update writes a lockfile that fails the next --frozen-lockfile install | CI frozen installs error after dependency updates | Run bun install once locally after updating and commit the lockfile | Issue closed as duplicate; fix PR #31752 still open |
Test runner
| Issue | Impact | Workaround | Status (2026-08-02) |
|---|---|---|---|
--isolate / --parallel in 1.3.13 crash with native NAPI addons | Segfaults in suites loading native addons | Upgrade to 1.3.14 or newer | Fixed in 1.3.14 |
--isolate fails on dynamic import of top-level-await modules (1.3.14 regression) | Test files using TLA dynamic imports error out | Run affected suites serially until fixed | Open |
Redis client
| Issue | Impact | Workaround | Status (2026-08-02) |
|---|---|---|---|
subscribe() silently drops messages after downgrading to RESP2 with HELLO 2 | Subscriber connections stop receiving messages without errors | Don't downgrade the protocol; stay on RESP3 (Redis 7.2+) | Open |
send() hangs forever after reconnecting during a large EVAL request | Requests never return after the connection recovers | Wrap send() calls in an application-level timeout | Open |
Conventions
- The "Status" column is a snapshot from the review date, not live state; the issue page is always newer.
- Absence from this list is not a guarantee: validate under the production baseline before adopting.
- Before recording a new defect here, confirm causality with a minimal reproduction and a specific Bun version.
Official references: oven-sh/bun issues, Bun releases.