寻找支持npm workspaces的Serverless打包插件（AWS Lambda部署场景）

现成插件替代方案 #

• serverless-esbuild：利用esbuild的原生能力直接解析npm workspaces依赖，完美适配monorepo结构，能自动处理依赖提升与本地包引用。配置示例：
  在serverless.yml中添加：

  plugins:
    - serverless-esbuild
  custom:
    esbuild:
      bundle: true
      minify: true
      sourcemap: false
      platform: node
      target: node18 # 匹配你的Lambda运行时版本
      external: ['aws-sdk'] # AWS SDK无需打包
      workspaces: true # 开启npm workspaces支持
  

  该插件会自动识别workspace内的包依赖，将所需内容打包进Lambda部署包，无需手动处理链接逻辑。

• serverless-webpack：配合webpack-node-externals与自定义路径解析，也可实现正确打包。在webpack.config.js中配置：

  const path = require('path');
  const nodeExternals = require('webpack-node-externals');
  
  module.exports = {
    entry: './handler.js',
    target: 'node',
    externals: [nodeExternals({
      allowlist: ['@your-workspace/utils'] // 指定需要打包的workspace内部包
    })],
    resolve: {
      modules: [path.resolve(__dirname, 'node_modules'), 'node_modules'],
      extensions: ['.js', '.json'],
      alias: {
        '@your-workspace/utils': path.resolve(__dirname, '../packages/utils')
      }
    },
    output: {
      libraryTarget: 'commonjs2',
      path: path.resolve(__dirname, '.webpack'),
      filename: 'handler.js'
    }
  };
  

  随后在serverless.yml中启用serverless-webpack插件即可。

自定义脚本方案（插件无法满足时） #

若现有插件均不符合需求，可编写部署前自定义脚本，核心步骤如下：

1. 创建临时打包目录，将当前Lambda服务的代码复制到该目录。
2. 解析package.json中的workspace依赖，将本地子包代码复制到临时目录的node_modules对应路径。
3. 执行npm install --production安装生产依赖，确保workspace依赖被正确安装。
4. 压缩临时目录为zip包，交由Serverless部署。

示例bash脚本：

#!/bin/bash

# 创建临时打包目录
TMP_DIR="./tmp-lambda-package"
rm -rf $TMP_DIR
mkdir -p $TMP_DIR

# 复制当前服务核心文件
cp -r ./handler.js ./package.json $TMP_DIR/

# 复制workspace内部依赖包（假设子包路径为../packages/utils）
mkdir -p $TMP_DIR/node_modules/@your-workspace/utils
cp -r ../packages/utils/* $TMP_DIR/node_modules/@your-workspace/utils/

# 安装生产依赖
cd $TMP_DIR
npm install --production

# 压缩打包
zip -r ../lambda-package.zip .

# 清理临时文件
cd ..
rm -rf $TMP_DIR

然后在serverless.yml中配置使用该zip包：

package:
  artifact: ./lambda-package.zip

额外建议 #

• 确保package.json中的workspaces字段正确包含所有子包路径，避免依赖解析错误。
• 保持Lambda运行时Node.js版本与本地开发环境一致，减少依赖兼容性问题。
• 打包后可通过unzip -l lambda-package.zip检查部署包内容，确认所需文件与依赖已全部包含。

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