Vitest 在 pool: threads 中运行原生 Node.js 模块出现 Segmentation fault 怎么排查【免费下载链接】vitestNext generation testing framework powered by Vite.项目地址: https://gitcode.com/GitHub_Trending/vi/vitest如果你的 Vitest 项目为了提速显式开启了pool: threads而测试加载了原生 Node.js 模块如Prisma、bcrypt、canvas这类以原生语言编写的库运行时可能出现Segmentation fault (core dumped)之类的崩溃。Vitest 官方文档 Common Errors 的 Segfaults and Native Code Errors 一节直接描述了这一现象在pool: threads中运行原生 NodeJS 模块可能触发来自原生代码的晦涩报错而修复方式是把 pool 切换为forks。先确认现象四类来自原生代码的报错根据 Common Errors 文档在pool: threads下运行原生模块时可能看到的错误包括Segmentation fault (core dumped)thread unnamed panicked at assertion failedAbort trap: 6internal error: entered unreachable code只要终端输出中出现上面任意一条并且你的测试依赖了原生模块就可以按本文的路径处理。文档对根因的解释是该原生模块很可能没有按多线程安全multi-thread safe来构建。而threadspool 正是用node:worker_threads来运行测试的见 自定义 Pool 文档所以崩溃发生在原生代码内部报错本身往往很难直接定位到具体模块。Vitest 的默认 pool 是forks见 pool 配置文档。如果你从未显式配置过pool默认就不会走threads出现本文这种 segfault通常意味着配置或命令行里启用了pool: threads。可以先全局检查vitest.config.ts/vitest.config.js中的test.pool以及 CI 脚本里的--pool参数确认是谁把它设成了threads。修复切换到 pool: forks文档给出的 workaround 是切换为pool: forks它用node:child_process而不是node:worker_threads来运行测试用例从而绕开原生模块的多线程问题。在配置文件vitest.config.js/vitest.config.ts中修改test.poolimport { defineConfig } from vitest/config export default defineConfig({ test: { pool: forks, }, })或者不改配置文件直接用 CLI 参数验证vitest --poolforkspool可选值为threads | forks | vmThreads | vmForks默认值forksCLI 参数形式为--poolvalue来源pool 配置文档。验证用forks重跑之前崩溃的测试vitest --poolforks之前的Segmentation fault (core dumped)或上面列出的其他原生报错不再出现测试正常跑完即说明切换生效。可以先用单条命令只对涉及原生模块的测试文件跑一次确认无误后再把pool: forks写回配置文件让所有环境包括 CI都走 forks。forks 的取舍与可选的隔离方案切到forks是有性能代价的文档明确了两点pool 配置文档 说明forks与主进程之间的通信不如threads快性能调优文档 也指出forkspool 在兼容性上更有优势进程挂起、segfault 等问题但在大型项目里可能比pool: threads略慢。也就是说threads换forks是用一点运行时间换取原生模块的兼容性这与文档推荐是一致的。另外注意一个方向相反的边界threads下无法使用process相关 API如process.chdir()而forks下这些 API 可用——如果你的代码依赖process.chdir()forks还顺带解决这个限制。如果只有少数测试文件依赖原生模块不想让整个测试套都降速可以用projects把不同 pool 分给不同项目不依赖原生模块的项目继续threads依赖原生模块的项目单独设pool: forks。多项目用法见 projects 指南内联定义的 project 默认通过extends继承根配置也可以用--project只跑某一个项目示例配置import { defineConfig } from vitest/config export default defineConfig({ test: { projects: [ { test: { name: unit, include: [**/*.test.ts], pool: threads, }, }, { test: { name: native, include: [**/native/*.test.ts], pool: forks, }, }, ], }, })以上include路径请按自己的测试文件位置替换分 pool 的写法参照 自定义 Pool 文档 中按项目配置不同 pool的示例。限制文档的结论是原生模块很可能不是多线程安全的Vitest 侧的 workaround 是换 pool文档没有承诺能修复原生模块本身的问题。如果某个原生模块在forks下仍崩溃那就超出了本文档覆盖的范围需要回到该原生模块自身排查。本文只覆盖pool: threads下的 segfaultpool: vmThreads/pool: vmForks属于 VM 沙箱 pool文档指出它们有自己的一组限制如 VM 模块跑 ESM 不稳定、内存泄漏等不要为了绕过 segfault 而改到 vm 系列 pool 上。【免费下载链接】vitestNext generation testing framework powered by Vite.项目地址: https://gitcode.com/GitHub_Trending/vi/vitest创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Vitest 在 pool: threads 中运行原生 Node.js 模块出现 Segmentation fault 怎么排查【免费下载链接】vitestNext generation testing framework powered by Vite.项目地址: https://gitcode.com/GitHub_Trending/vi/vitest如果你的 Vitest 项目为了提速显式开启了pool: threads而测试加载了原生 Node.js 模块如Prisma、bcrypt、canvas这类以原生语言编写的库运行时可能出现Segmentation fault (core dumped)之类的崩溃。Vitest 官方文档 Common Errors 的 Segfaults and Native Code Errors 一节直接描述了这一现象在pool: threads中运行原生 NodeJS 模块可能触发来自原生代码的晦涩报错而修复方式是把 pool 切换为forks。先确认现象四类来自原生代码的报错根据 Common Errors 文档在pool: threads下运行原生模块时可能看到的错误包括Segmentation fault (core dumped)thread unnamed panicked at assertion failedAbort trap: 6internal error: entered unreachable code只要终端输出中出现上面任意一条并且你的测试依赖了原生模块就可以按本文的路径处理。文档对根因的解释是该原生模块很可能没有按多线程安全multi-thread safe来构建。而threadspool 正是用node:worker_threads来运行测试的见 自定义 Pool 文档所以崩溃发生在原生代码内部报错本身往往很难直接定位到具体模块。Vitest 的默认 pool 是forks见 pool 配置文档。如果你从未显式配置过pool默认就不会走threads出现本文这种 segfault通常意味着配置或命令行里启用了pool: threads。可以先全局检查vitest.config.ts/vitest.config.js中的test.pool以及 CI 脚本里的--pool参数确认是谁把它设成了threads。修复切换到 pool: forks文档给出的 workaround 是切换为pool: forks它用node:child_process而不是node:worker_threads来运行测试用例从而绕开原生模块的多线程问题。在配置文件vitest.config.js/vitest.config.ts中修改test.poolimport { defineConfig } from vitest/config export default defineConfig({ test: { pool: forks, }, })或者不改配置文件直接用 CLI 参数验证vitest --poolforkspool可选值为threads | forks | vmThreads | vmForks默认值forksCLI 参数形式为--poolvalue来源pool 配置文档。验证用forks重跑之前崩溃的测试vitest --poolforks之前的Segmentation fault (core dumped)或上面列出的其他原生报错不再出现测试正常跑完即说明切换生效。可以先用单条命令只对涉及原生模块的测试文件跑一次确认无误后再把pool: forks写回配置文件让所有环境包括 CI都走 forks。forks 的取舍与可选的隔离方案切到forks是有性能代价的文档明确了两点pool 配置文档 说明forks与主进程之间的通信不如threads快性能调优文档 也指出forkspool 在兼容性上更有优势进程挂起、segfault 等问题但在大型项目里可能比pool: threads略慢。也就是说threads换forks是用一点运行时间换取原生模块的兼容性这与文档推荐是一致的。另外注意一个方向相反的边界threads下无法使用process相关 API如process.chdir()而forks下这些 API 可用——如果你的代码依赖process.chdir()forks还顺带解决这个限制。如果只有少数测试文件依赖原生模块不想让整个测试套都降速可以用projects把不同 pool 分给不同项目不依赖原生模块的项目继续threads依赖原生模块的项目单独设pool: forks。多项目用法见 projects 指南内联定义的 project 默认通过extends继承根配置也可以用--project只跑某一个项目示例配置import { defineConfig } from vitest/config export default defineConfig({ test: { projects: [ { test: { name: unit, include: [**/*.test.ts], pool: threads, }, }, { test: { name: native, include: [**/native/*.test.ts], pool: forks, }, }, ], }, })以上include路径请按自己的测试文件位置替换分 pool 的写法参照 自定义 Pool 文档 中按项目配置不同 pool的示例。限制文档的结论是原生模块很可能不是多线程安全的Vitest 侧的 workaround 是换 pool文档没有承诺能修复原生模块本身的问题。如果某个原生模块在forks下仍崩溃那就超出了本文档覆盖的范围需要回到该原生模块自身排查。本文只覆盖pool: threads下的 segfaultpool: vmThreads/pool: vmForks属于 VM 沙箱 pool文档指出它们有自己的一组限制如 VM 模块跑 ESM 不稳定、内存泄漏等不要为了绕过 segfault 而改到 vm 系列 pool 上。【免费下载链接】vitestNext generation testing framework powered by Vite.项目地址: https://gitcode.com/GitHub_Trending/vi/vitest创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
