SuiteCloud CLI for Node.js 1.5.0无JAR文件报错如何解决

问题确认 #

• 该报错是1.5.0版本的已知共性bug，已有大量同版本用户反馈相同异常，官方虽标注已修复，但全局安装场景下因权限问题仍有较高概率触发
• 报错触发时的提示信息如下：

There is no JAR File in your CLI for Node.JS. Run "npm install from /usr/lib/node_module/@oracle/suitecloud-cli" to install a JAR file

• 同环境下VS Code SuiteCloud扩展可正常运行属于正常现象：扩展自带独立的JAR运行时，和全局Node版CLI的依赖不互通，且扩展本身未覆盖全部CLI功能，无法完全替代命令行工具

手动安装JAR的操作步骤 #

• 注意：报错提示中打印的路径存在笔误，node_module应为复数形式node_modules，如果你的Node全局模块默认安装在/usr/lib下，直接执行命令进入对应目录：
  cd /usr/lib/node_modules/@oracle/suitecloud-cli
  如果找不到对应路径，先执行npm root -g查询全局模块实际根目录，再拼接/@oracle/suitecloud-cli进入目标文件夹
• 进入目录后执行依赖重装，触发内置的JAR拉取逻辑：
  npm install
  正常情况下执行完成后JAR文件会被自动下载到对应目录，重启终端后CLI即可正常使用
• 如果上述步骤执行后仍提示JAR缺失，手动执行目录下的安装脚本即可：
  node ./scripts/install.js

补充说明 #

• 该问题的核心诱因是全局安装npm包时的权限不足，导致安装流程的postinstall钩子没有正常触发，JAR依赖没有被自动下载，并非CLI本身文件损坏
• 如果手动修复后仍频繁复现问题，直接升级到1.6.0及以上稳定版本即可，官方在后续版本调整了JAR校验和拉取逻辑，不会再因为安装钩子执行失败导致CLI完全不可用

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