Jenkins流水线安装AWS Lambda依赖失败求助排查

核心问题原因 #

1. 依赖目录不匹配：你的项目中CDK和Lambda模块各有独立的package.json，Jenkins的Build阶段默认在CDK根目录执行npm install，只会安装CDK的依赖包；而eslint定义在Lambda模块的devDependencies里，当前目录未安装该包，自然找不到。
2. 本地与Jenkins环境差异：本地执行正常要么是你在Lambda目录下运行命令，要么是本地全局安装了eslint，但Jenkins Agent既没有全局安装该工具，也没在正确目录安装依赖。

排查步骤 #

1. 确认工作目录
   在Build阶段添加路径打印命令，验证Jenkins当前执行目录：

   stage('Build') {
     steps {
        sh 'pwd' // 输出当前工作目录，确认是否在CDK根目录
        sh 'npm install --unsafe-perm'
        sh 'npm run lint'
      }
   }
   

   如果输出是CDK根目录，说明问题出在未切换到Lambda目录执行依赖安装和lint。

2. 检查依赖安装结果
   修改步骤添加依赖列表检查，确认eslint是否被安装：

   stage('Build') {
     steps {
        sh 'npm install --unsafe-perm --verbose' // 打印安装日志，排查是否有安装失败
        sh 'npm list eslint' // 查看当前目录是否安装了eslint
        sh 'npm run lint'
      }
   }
   

   如果npm list eslint输出"empty"或提示"eslint not found"，说明当前目录确实未安装该包。

3. 验证lint脚本定义
   检查CDK根目录的package.json里是否有lint脚本：如果没有，npm run lint本身就会报错；如果有，确认脚本是否正确指向了Lambda代码的检查逻辑。

解决方案 #

根据项目结构，推荐以下两种方式：

方式1：切换到Lambda目录执行lint #

如果lint是针对Lambda代码的，在Jenkins步骤里切换到Lambda所在目录执行依赖安装和lint：

stage('Build') {
  steps {
     // 先安装CDK依赖（后续部署需要）
     sh 'npm install --unsafe-perm'
     // 切换到Lambda目录，安装依赖并执行lint
     sh 'cd ./path/to/your/lambda && npm install --unsafe-perm && npm run lint'
   }
}

注意把./path/to/your/lambda替换成实际的Lambda模块相对路径。

方式2：全局安装eslint（不推荐，依赖环境） #

在Jenkins Agent上全局安装eslint，这样不管哪个目录都能调用：

stage('Build') {
  steps {
     sh 'npm install -g eslint'
     sh 'npm install --unsafe-perm'
     sh 'npm run lint'
   }
}

这种方式的缺点是依赖Jenkins Agent的环境配置，换个Agent可能又会出问题，不如方式1可靠。

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