WSL环境运行Bun执行bun install报错的修复方案咨询

问题复现命令与报错 #

执行包安装命令：

bun install

返回错误信息：

error: Failed to initialize network thread: SystemOutdated.
HTTP requests will not work. Please file an issue and run strace().

报错原因 #

该错误是Bun内置的运行环境校验逻辑触发的：当前环境的Linux内核版本低于Bun网络模块要求的最低版本，网络线程无法完成初始化，所有依赖HTTP请求的功能都会被直接阻断。

有效修复方案 #

• 升级Linux内核到5.10及以上长期支持版本：这是官方适配的根治方案，升级完成后重启系统即可正常运行所有Bun命令。不同场景的升级方式：
  • Ubuntu/Debian物理机/虚拟机：安装对应发行版版本的HWE内核包，执行sudo apt install --install-recommends linux-generic-hwe-$(lsb_release -rs)后重启即可
  • CentOS/RHEL系：建议直接升级到EL8/EL9版本，或通过系统兼容的第三方软件源安装5.10以上长期支持内核
  • WSL2环境：在Windows终端执行wsl --update升级WSL2内核，重启WSL实例后即可恢复
• 临时降级Bun版本：如果暂时没有权限升级内核，可以将Bun回退到1.0正式版发布前的历史版本（比如0.8.x系列），旧版本未强制加入内核版本校验逻辑，可以在低版本内核环境下正常运行，安装时在Bun安装命令后追加对应版本号参数即可。
• 容器环境修复：Docker、LXC这类容器共享宿主机内核，仅替换容器内的系统镜像无法解决内核版本过低的问题，需要将宿主机内核升级到5.10及以上版本，或迁移到符合内核版本要求的宿主机上运行。

注意：不要尝试通过修改二进制、跳过校验的方式强行运行高版本Bun，后续使用中会出现网络请求随机崩溃、TLS握手失败、依赖安装不完整等隐性问题，没有实际使用价值。

内容的提问来源于stack exchange，提问作者sno2