
目录
[方案 1:服务器安装缺失依赖(推荐,一劳永逸)](#方案 1:服务器安装缺失依赖(推荐,一劳永逸))
[CentOS7 / Anolis OS 7](#CentOS7 / Anolis OS 7)
[CentOS8 / Rocky8 / Anolis8](#CentOS8 / Rocky8 / Anolis8)
[方案 2:不想装系统依赖 → 降级 Node 版本(兼容老系统)](#方案 2:不想装系统依赖 → 降级 Node 版本(兼容老系统))
[方案 3:离线环境无外网,手动补充 libatomic(离线服务器专用)](#方案 3:离线环境无外网,手动补充 libatomic(离线服务器专用))
[补充说明 SonarQube 关联逻辑](#补充说明 SonarQube 关联逻辑)
jenkins报错信息:
15:44:4.933 ERROR node: error while loading shared libraries: libatomic.so.1: cannot open shared object file: No such file or directory 15:44:45.935 ERROR Failed to determine the version of Node.js, exit value 127. Executed: 'node -v' org.sonarsource.nodejs.NodeCommandException: Failed to determine the version of Node.js, exit value 127. Executed: 'node -v' at org.sonarsource.nodejs.NodeCommandBuilderImpl.getVersion(NodeCommandBuilderImpl.java:206)
报错 libatomic.so.1: No such file or directory 不是 Jenkins 配置问题,是系统缺少 Node26 运行必需的共享库文件 : Node.js 26 高版本编译时依赖 libatomic.so.1,你的服务器系统(大概率 CentOS7 / Anolis7)默认未预装该库,二进制文件存在但无法执行,返回 exit code 127。
方案 1:服务器安装缺失依赖(推荐,一劳永逸)
CentOS7 / Anolis OS 7
bash
yum install -y libatomic
CentOS8 / Rocky8 / Anolis8
bash
dnf install -y libatomic
Debian/Ubuntu
bash
apt update && apt install -y libatomic1
安装完成后重新构建 Jenkins 任务 ,node -v 即可正常运行。
方案 2:不想装系统依赖 → 降级 Node 版本(兼容老系统)
CentOS7 原生 glibc 版本偏低,Node 24+ 都会出现 libatomic 依赖问题,解决:
- 进入 Jenkins【系统管理】→【全局工具配置】→ NodeJS
- 删除
NodeJS26.5,新建 Node 工具,选择 Node 20.x LTS(20.xx) - 任务下拉框切换为新的 Node20 工具名称,保存构建 Node20 不强制依赖 libatomic.so.1,老 Linux 系统可直接运行。
方案 3:离线环境无外网,手动补充 libatomic(离线服务器专用)
-
在同版本能联网的机器下载安装包 CentOS7:
yumdownloader libatomic -
将 rpm 包上传 Jenkins 服务器,本地安装
bashrpm -ivh libatomic-*.rpm
补充验证命令(安装后校验库是否存在)
bash
# 检查库文件
ls /usr/lib64/libatomic.so.1
# 手动执行node测试
/var/jenkins_home/tools/nodejs/NodeJS26.5/node-*/bin/node -v
输出版本号即代表依赖修复完成。
补充说明 SonarQube 关联逻辑
日志里 org.sonarsource.nodejs.NodeCommandException 是 Sonar 扫描器调用 node 做 JS/TS 代码分析触发的报错,根源还是 node 无法启动,修复 libatomic 或降级 Node 后 Sonar 报错会同步消失。