worker_threads Worker exit aborts (SIGABRT) when a native addon (fsevents) has an in-flight napi_threadsafe_function — napi_release_threadsafe_function / uv_mutex_lock
還沒有人認領這個 Issue。
評估
- 難度
- 4/5
- 預估耗時
- 3-5 天
- 新手友好度
- 48/100
- Issue 類型
- 缺陷
- 描述清晰度
- 基本清楚
- 活躍度
- 冷清
- 技術堆疊
- javascript, node.js
研究方向
從最小重現的 main.mjs 和 worker.mjs 開始:執行 npm install 和 node main.mjs 50,然後比較 v24.11.1 與 v24.15.0 或更新版本。追蹤 stack 中顯示的 worker teardown 路徑,尤其是 napi_release_threadsafe_function 和 Environment::RunCleanup。完成的標準是全部 50 個 worker 都以代碼 0 結束,且沒有 SIGABRT。
由索引模型根據 Issue 內容生成。
描述
Version
v24.15.0 through v24.19.0 (tested v24.15.0, v24.16.0, v24.19.0 — all crash).
Does NOT reproduce on v24.11.0 or v24.11.1.
Platform
macOS 15.6.1 (24G90), Apple Silicon (arm64)
Subsystem
worker_threads, N-API (napi_threadsafe_function)
What steps will reproduce the bug?
Minimal repro repo: https://github.com/mastoj/node24-fsevents-worker-threads-abort
npm installnode main.mjs 50
main.mjs spawns 50 worker_threads.Workers sequentially. Each worker
(worker.mjs) does:
import { createRequire } from "node:module";
const require = createRequire(import.meta.url);
const fsevents = require("fsevents");
fsevents.watch(process.argv[2], () => {});
setTimeout(() => process.exit(0), 5);
i.e. it starts a native fsevents watch (which registers a
napi_threadsafe_function under the hood) and exits the worker shortly
after, without explicitly stopping the watcher first.
How often does it reproduce? Is there a required condition?
100% reproducible on Node.js v24.15.0+ on macOS. Crashes on the very first
worker. 0% reproducible on Node.js v24.11.0/v24.11.1 (ran 50 workers cleanly).
What is the expected behavior?
All workers start, watch, and exit cleanly with code 0:
worker 0 exited with code 0
...
worker 49 exited with code 0
done, no crash across 50 workers
(This is what actually happens on v24.11.0.)
What do you see instead?
The whole process aborts with SIGABRT (exit code 134) on the very first
worker — before any of the console.log lines are even printed, since the
abort takes down the entire process (all worker threads share one OS
process).
$ node main.mjs 50
Abort trap: 6
$ echo $?
134
macOS crash reporter consistently shows the same stack trace on the
"WorkerThread":
__pthread_kill
pthread_kill
abort
uv_mutex_lock
napi_release_threadsafe_function
fse_instance_destroy
napi_env__::CallIntoModule<...>
node_napi_env__::CallFinalizer(void (*)(napi_env__*, void*, void*), void*, void*)
v8impl::Reference::Finalize()
node_napi_env__::DeleteMe()
node::Environment::CloseHandle<...>
uv_run
node::Environment::RunCleanup()
node::FreeEnvironment(node::Environment*)
node::worker::Worker::Run()
node::worker::Worker::StartThread(...)::$_0::__invoke(void*)
_pthread_start
thread_start
i.e. during worker-thread Environment teardown, napi_release_threadsafe_function
attempts uv_mutex_lock while finalizing fsevents' native threadsafe
function, and this ends in abort() instead of a clean/graceful teardown.
Additional context
This was originally found as a crash inside a real-world Next.js 16.3.0
monorepo build (next build --turbopack), where Next's build worker threads
transitively load fsevents (via chokidar/watchpack) and exit shortly
after doing their work. The exact same crash signature (same stack trace)
was observed across 15+ independent crash reports collected via macOS's
crash reporter during real builds, before being reduced to this minimal,
Next.js-free, fsevents-only reproduction.
It doesn't reproduce in a fresh create-next-app project (which doesn't
happen to have an active fsevents watcher inside its build workers) —
only projects where a native addon with an in-flight
napi_threadsafe_function is active in a worker thread at worker-exit
time.
- 主要語言
- JavaScript
- 星號
- 122k
- 分支
- 37.4k
- 平均合併
- 4 天 2 小時
- 30 天內合併 PR
- 277
貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
nodejs/node 的其他 Issue
-
doc
難度 2/5 1-3 小時 新手友好度 65/100
-
build
難度 1/5 1 小時以內 新手友好度 88/100
-
難度 2/5 1-3 小時 新手友好度 84/100
-
難度 1/5 1 小時以內 新手友好度 90/100
-
feature request
難度 2/5 1-3 小時 新手友好度 68/100
相似的 Issue
-
難度 2/5 1-3 小時 新手友好度 82/100
-
area-deployment area-integrations triage:bot-seen
難度 2/5 半天 新手友好度 86/100
-
Issue-Bug
難度 2/5 1-3 小時 新手友好度 68/100
sugarlabs/musicblocks#8924 ·
-
難度 1/5 1 小時以內 新手友好度 90/100
ArduPilot/ardupilot_wiki#8088 ·
-
[BUG] createTool tools cannot be registered with Mastra when exactOptionalPropertyTypes is enabled 未關閉customer-eng status: needs triage
難度 2/5 1-3 小時 新手友好度 84/100