如何让AWS SAM sync仅部署修改过的AWS Lambda函数？

核心原因分析 #

你的问题大概率是子栈C将多个Lambda打包在了同一个代码包里，或者SAM模板中未正确配置每个Lambda的CodeUri指向独立的编译产物目录。当你修改Lambda3的代码时，整个子栈C的代码包被标记为变更，导致所有关联Lambda都被重新部署。另外，如果子栈A的层被多个Lambda共享且层的依赖包未做隔离，也可能触发连锁部署，但你的情况更偏向代码包的问题。

分步解决方案 #

1. 为每个Lambda配置独立的CodeUri #

确保每个Lambda在SAM模板中都指向自己的编译后代码目录，而非共享同一个根目录。示例配置：

# 子栈C的模板片段
Resources:
  Lambda2Function:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: dist/lambda2/  # 独立编译目录
      Runtime: nodejs20.x
      # 其他配置项...
  Lambda3Function:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: dist/lambda3/  # 独立编译目录
      Runtime: nodejs20.x
      # 其他配置项...

同时调整TypeScript的编译配置：用tsconfig.json的outDir或打包工具（如esbuild、webpack）为每个Lambda单独编译打包，确保产物目录完全隔离。

2. 精准使用sam sync参数组合 #

你之前尝试的--code和--resource-id需要配合完整的资源ID使用：

• 先执行sam list resources命令，确认目标Lambda的完整资源ID（格式为子栈名/资源名，例如SubStackC/Lambda3Function）
• 执行精准同步命令：

sam sync --code --resource-id SubStackC/Lambda3Function

注意：Lambda位于子栈时，必须指定子栈名+资源名的完整ID，仅写Lambda名称会导致SAM无法定位到正确资源。

3. 优化层的依赖与更新策略 #

如果子栈A的层被多个Lambda共享：

• 层只存放公共依赖包（如第三方库），不要放入Lambda业务代码
• 仅当层的依赖确实变更时，执行sam sync --resource-id SubStackA/目标层名称单独同步层，避免触发所有Lambda部署

4. 启用SAM增量打包优化 #

在samconfig.toml中添加配置，让SAM只打包变更的文件：

[default.sync.parameters]
use_incremental_build = true

该配置会让SAM跟踪文件变更记录，仅重新打包有修改的代码目录，减少不必要的打包和部署操作。

验证方法 #

修改Lambda3的代码后，先执行sam build --use-container（如果使用容器构建），再执行精准同步命令，观察SAM输出确认仅目标Lambda被部署。

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