一个简洁有效的修复方案,解决安装思源笔记时出现的A JavaScript error occurred in the main process错误。 “spawn SiYuan-kernel ENOENT” 和 “获取内核服务端口失败” 错误

问题背景
最近在 Linux Mint 22 上安装思源笔记(特别是解锁版)时,许多用户遇到了相同的错误:
A JavaScript error occurred in the main process
Uncaught Exception:
Error:spawn/tmp/.mount_siyuanxqG7tC/resources/kernel/SiYuan-kernel ENOENT
...
获取内核服务端口失败 Failed to get kernel serve port
这个错误通常发生在较新的 Linux 发行版上(如基于 Ubuntu 24.04 的 Linux Mint 22),根本原因是系统缺少必要的兼容库。经过多次测试,我发现安装 musl 库 是最简单有效的解决方案。

解决方案:安装 musl 库
只需在终端执行以下命令即可解决问题:
sudo apt update && sudo apt install musl-dev musl-tools -y
安装完成后,重新启动思源笔记应用,错误应该已经消失。
完整步骤说明
- 打开终端 (Ctrl+Alt+T)
- 更新软件包列表:
sudo apt update
- 安装 musl 库:
sudo apt install musl-dev musl-tools -y
- 重新启动思源笔记
为什么 musl 能解决问题?
musl 是一个轻量级的 C 标准库实现,它解决了 Linux Mint 22 的几个兼容性问题:
- glibc 版本冲突:Linux Mint 22 使用较新的 glibc (2.39+),而思源笔记内核可能使用旧版本编译
- 符号链接缺失:musl 提供了兼容的符号链接接口
- 动态链接问题:解决了
SiYuan-kernel
的运行时依赖问题