WhatBrokeToday
GTA 6FAQ
Bun

Bun FFI dlopen Throws Incorrect Error Type for Missing Symbols

minor

Is it fixed? Not yet.

Ongoing since Nov 13, 15:44 UTC. First reported Nov 13, 15:44 UTC.

What happened

Bun's FFI `dlopen` incorrectly throws an `ERR_INVALID_ARG_TYPE` error when a shared library lacks a required symbol, instead of throwing an `ERR_DLOPEN_FAILED` error. This affects developers attempting to load libraries on systems with older glibc versions where certain symbols are absent. The issue is present in versions 1.4.4 and the 1.4.5 canary release.

What caused it?

On platforms with older glibc versions (such as Debian 11 with glibc 2.31) where specific symbols like pidfd_open are missing from libc.so.6, `dlopen` fails to find the symbol and incorrectly triggers `ERR_INVALID_ARG_TYPE`.

No verified workaround yet

None of the linked reports describe a mitigation. This page updates when one appears.

Official fix

Timeline

  1. Investigating(current)
  2. Workaround available(upcoming)
  3. Resolved(upcoming)
  1. First report on GitHub issue

    bun:ffi dlopen: a symbol the library lacks throws ERR_INVALID_ARG_TYPE, where a library it cannot open throws ERR_DLOPEN_FAILED

    Source

Evidence

1 report · 1 GitHubShow
  1. [1]
    GitHub First report
    bun:ffi dlopen: a symbol the library lacks throws ERR_INVALID_ARG_TYPE, where a library it cannot open throws ERR_DLOPEN_FAILED(opens GitHub issue in a new tab)

    What version of Bun is running? 1.4.5 (d0f4fdd65fbd9548042aa5cd811a08f837ce4b4c), the canary; also 1.4.4 (38afee6c84fcf48c0edb2466aa4b27d287a59c30) What platform is your computer? Linux 6.18.58.1-microsoft-standard-WSL2 x86_64 unknown, in a debian:bullseye container (glibc 2.31) What steps can reproduce the bug? pidfd_open was added to glibc in 2.36, so on Debian 11 (glibc 2.31) libc.so.6 opens but has no such symbol: import { dlopen, FFIType } from 'bun:ffi'; dlopen('libdoes-not-exist.so', {…

    by YevheniiKotyrlo 0upvotes 0comments

FAQ

What happened in the Bun outage?

Bun's FFI `dlopen` incorrectly throws an `ERR_INVALID_ARG_TYPE` error when a shared library lacks a required symbol, instead of throwing an `ERR_DLOPEN_FAILED` error. This affects developers attempting to load libraries on systems with older glibc versions where certain symbols are absent. The issue is present in versions 1.4.4 and the 1.4.5 canary release.

What is affected by the Bun outage?

Bun (versions: 1.4.4, 1.4.5 canary).

When did the Bun outage start and end?

It started Nov 13, 15:44 UTC and is still ongoing (5 d 12 h so far). This page updates as it develops.

How do I get alerts for Bun?

Subscribe to the Bun RSS feed for every new Bun incident, or connect an AI assistant to WhatBrokeToday over MCP and ask whether Bun is down. Bun feed

Where does this information come from?

WhatBrokeToday collects public status pages, developer community reports and security advisories, groups the ones about the same problem, and links every report under Evidence on this page. This one has 1 report from 1 independent source.