Jenkins运行SampleExpressApp代码报错，寻求排查解决方案

一、先确认项目核心依赖环境 #

• 这是Node.js项目，核心依赖是Node.js和npm，优先排查Jenkins服务器的Node.js环境：
  • 登录Jenkins服务器，执行命令 node -v 和 npm -v，能返回版本号说明已安装；若未安装，需安装项目package.json中engines字段指定的对应版本
• 关于JDK：Node.js项目本身不需要JDK，但如果教程涉及Java相关步骤，需检查Jenkins全局工具配置中是否添加了JDK，且构建任务已指定正确的JDK路径

二、检查Jenkins构建任务配置 #

• 验证源码拉取：查看Jenkins构建日志，确认是否成功拉取完整代码，无文件缺失或权限报错
• 确认构建步骤完整性：
  • 是否执行了 npm install 安装依赖？这是Node.js项目启动的必要步骤，漏执行会导致依赖缺失报错
  • 启动命令是否正确？比如是否使用 npm start，或直接指定入口文件（如 node app.js）
• 检查环境变量：是否配置了项目所需的端口、数据库连接等环境变量

三、提取详细报错信息定位问题 #

• 查看Jenkins构建日志中的完整错误堆栈，关键词如 Error: Cannot find module（依赖缺失）、listen EADDRINUSE（端口被占用）、permission denied（权限不足）等，可直接定位问题
• 也可在Jenkins服务器本地手动执行项目启动流程，复现错误后更易排查

四、核对教程关键步骤 #

• 检查是否安装了Jenkins的Node.js插件（NodeJS Plugin），未安装需在插件管理中添加
• 确认构建任务是否指定了全局工具配置中已设置的Node.js版本
• 检查Jenkins工作空间目录是否有读写权限

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