AWS SAM Sync权限错误求助：无法同步基础设施

核心问题分析 #

你的错误源于RuntimeDependenciesLayer配置不合理：将ContentUri设为./会让SAM把整个项目目录打包为层内容，导致项目自身被误复制到层的node_modules目录中，加上Windows环境下可能存在的文件锁定，最终触发权限拒绝错误。

分步解决 #

1. 修正层的配置 #

修改template.yml中的RuntimeDependenciesLayer，将层的内容指向专门的目录，避免打包整个项目：

# Shared layer with Lambda runtime dependencies
RuntimeDependenciesLayer:
  Type: AWS::Serverless::LayerVersion
  Metadata:
    BuildMethod: makefile
  Properties:
    LayerName: "log-tracker-backend-dependencies"
    Description: Runtime dependencies for Lambdas
    ContentUri: ./layer  # 改为专属层目录
    CompatibleRuntimes:
      - nodejs18.x
    RetentionPolicy: Retain

2. 调整Makefile构建逻辑 #

在项目根目录创建layer文件夹，然后修改Makefile，确保依赖安装到层的标准目录结构下：

# 层构建规则
build-RuntimeDependenciesLayer:
    mkdir -p $(ARTIFACTS_DIR)/nodejs
    cp package.json package-lock.json $(ARTIFACTS_DIR)/nodejs/
    cd $(ARTIFACTS_DIR)/nodejs && npm install --production

# 保留原有的函数构建规则（如果有）
build-getLogsFunction:
    # 你的TypeScript编译逻辑，比如tsc等
    cp -r dist $(ARTIFACTS_DIR)/

build-postLogsFunction:
    # 你的TypeScript编译逻辑，比如tsc等
    cp -r dist $(ARTIFACTS_DIR)/

3. 清理SAM缓存目录 #

彻底删除旧的.aws-sam目录，清除残留的错误文件和权限锁定：

• Linux/macOS：

  rm -rf .aws-sam
  

• Windows PowerShell：

  Remove-Item -Recurse -Force .aws-sam
  

4. 解除文件占用（Windows环境） #

确认没有终端、编辑器（如VS Code）或其他进程打开.aws-sam目录下的文件，这些进程会锁定文件导致SAM无法删除。关闭相关程序后再继续。

5. 重新执行SAM Sync #

完成以上步骤后，重新运行同步命令：

sam sync --stack-name log-tracker-backend --watch

额外优化建议 #

• 检查package.json，确保没有将项目自身作为依赖（如file:.类型的本地依赖），避免node_modules中出现项目目录。
• 可以在samconfig.toml中添加sync默认参数，减少重复输入：

  [default.sync.parameters]
  stack_name = "log-tracker-backend"
  watch = true
  

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