能否将PNPM与AWS SAM搭配使用？部署遇问题求指引

核心问题原因 #

AWS SAM的打包逻辑默认适配npm/yarn的平铺式node_modules结构，但PNPM默认采用硬链接+虚拟存储的依赖管理方式，导致SAM无法正确识别依赖路径，最终部署后代码无法运行。

具体解决方案 #

1. 强制PNPM生成兼容的依赖结构

执行安装命令时添加--shamefully-hoist参数，让PNPM将所有依赖平铺到node_modules根目录，和npm/yarn的结构保持一致：

pnpm install --shamefully-hoist

之后再执行sam deploy，SAM就能正常识别并打包依赖。

2. 在SAM模板中指定PNPM构建命令

如果使用SAM的构建工具（比如esbuild），可以在template.yaml的函数元数据里明确指定用PNPM处理依赖：

Resources:
  YourLambdaFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: ./src/
      Handler: index.handler
      Runtime: nodejs18.x
    Metadata:
      BuildMethod: esbuild
      BuildProperties:
        Command: pnpm install --shamefully-hoist && esbuild --bundle index.js --outdir=dist --platform=node --target=node18

这样SAM在构建时会先通过PNPM安装兼容结构的依赖，再用esbuild打包代码。

3. 采用代码打包方式彻底规避依赖结构问题

更可靠的方式是用打包工具（如esbuild、webpack）将代码和依赖打包成单个文件，这样就不需要SAM处理node_modules：

• 安装打包工具：pnpm add esbuild --save-dev
• 执行打包命令：

pnpm esbuild index.js --bundle --minify --platform=node --target=node18 --outfile=dist/index.js

• 在template.yaml中将CodeUri指向打包后的dist目录，同时确保排除原代码目录的node_modules。

4. 检查SAM打包排除规则

确认你的samconfig.toml或template.yaml中没有错误排除node_modules目录，比如全局或函数级的Exclude配置不要包含node_modules/**。

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