使用Serverless Compose部署时遇spawn serverless ENOENT错误

问题背景 #

使用Serverless Compose部署client-service时触发spawn serverless ENOENT错误，但前置的infra-test服务可正常部署完成。

环境信息 #

"@serverless/compose": "^1.3.0",
"serverless": "^3.22.0"

配置文件（serverless-compose.ts） #

const serverlessCompose = {
  services: {
    "infra-test": {
      path: "infra-test",
    },
    "client-service": {
      path: "client-'service'",
      dependsOn: ["infra-test"],
    },
  },
};

module.exports = serverlessCompose;

执行命令与错误日志 #

执行的部署命令：

serverless deploy --stage sbx

完整错误输出：

infra-test › 
infra-test › Stack Outputs:
infra-test ›   ServerlessDeploymentBucketName: infra-test-sbx-serverlessdeploymentbucket-yg91fd
infra-test › 3 deprecations found: run 'serverless doctor' for more details
infra-test › deployed
client-service › deploying
client-service › Running "serverless deploy --stage sbx"
client-service › error
client-service › spawn serverless ENOENT
client-service › Error: spawn serverless ENOENT
client-service ›     at Process.ChildProcess._handle.onexit (node:internal/child_process:283:19)
client-service ›     at onErrorNT (node:internal/child_process:476:16)
client-service ›     at processTicksAndRejections (node:internal/process/task_queues:82:21)

已尝试过的无效操作 #

• 降级serverless-dynamodb-local版本（从0.2.40到0.2.30）：

  npm uninstall serverless-dynamodb-local
  sls dynamodb uninstall
  
  npm install serverless-dynamodb-local@0.2.30
  sls dynamodb install
  

• 删除服务的所有本地Serverless依赖
• 将多Lambda服务改为单Lambda服务
• 安装sls dynamodb和OpenJDK 19

问题根源分析 #

spawn serverless ENOENT本质是系统找不到serverless命令的可执行文件，结合场景来看，核心触发点包括：

1. 服务路径配置错误：client-service的path字段包含多余单引号，导致Serverless Compose无法定位到服务目录，进而无法执行对应目录下的serverless命令
2. 全局/局部serverless命令不可用：全局命令未安装，或服务目录下的局部依赖缺失
3. 权限不足：当前用户无执行serverless命令的权限

可行解决步骤 #

1. 修正服务路径配置 #

直接修改serverless-compose.ts中client-service的path字段，移除多余的单引号：

const serverlessCompose = {
  services: {
    "infra-test": {
      path: "infra-test",
    },
    "client-service": {
      path: "client-service", // 移除多余的单引号
      dependsOn: ["infra-test"],
    },
  },
};

module.exports = serverlessCompose;

2. 确保serverless命令全局可用 #

先检查全局serverless是否正常安装：

serverless --version

若未输出正确版本，执行全局安装：

npm install -g serverless@3.22.0

3. 检查并修复局部依赖 #

进入client-service目录，确认serverless已作为开发依赖存在：

cd client-service
npm list serverless

若未找到，安装局部依赖：

npm install --save-dev serverless@3.22.0

4. 清理缓存后重新部署 #

清理Serverless缓存：

serverless cache clean

重新执行部署命令：

serverless deploy --stage sbx

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