如何在新SAM栈中引用并管理已有AWS Lambda函数？

要将手动创建的Lambda函数纳入SAM（Serverless Application Model）管理，核心是通过CloudFormation资源导入功能，让SAM栈关联已有Lambda资源。以下是直接可行的步骤：

步骤1：编写匹配现有Lambda的SAM模板 #

创建一个SAM模板，严格匹配你现有Lambda的配置，必须包含FunctionName（和现有函数名称完全一致），同时指定所有必要属性（运行时、Handler、执行角色等），添加DeletionPolicy: Retain避免误删。示例模板如下：

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Resources:
  MyExistingLambda:
    Type: AWS::Serverless::Function
    Properties:
      FunctionName: "my-existing-lambda-name" # 替换为你的Lambda函数名称
      Runtime: python3.9 # 匹配现有函数的运行时
      Handler: lambda_function.lambda_handler # 匹配现有函数的Handler路径
      CodeUri: ./src/ # 本地代码目录，后续用于更新
      Role: arn:aws:iam::123456789012:role/my-lambda-execution-role # 匹配现有函数的执行角色ARN
      Environment:
        Variables: # 如果有环境变量，完全匹配现有配置
          DB_HOST: "my-db-host"
    DeletionPolicy: Retain # 防止栈删除时误删Lambda

注意：模板中所有属性必须和现有Lambda完全一致，否则导入会失败。如果函数使用了层、VPC配置等，也要同步添加到模板中。

步骤2：打包SAM模板（若包含本地代码） #

如果你的Lambda代码存放在本地，先使用SAM CLI打包模板，生成可用于CloudFormation的打包后模板：

sam package --template-file template.yaml --output-template-file packaged-template.yaml --s3-bucket your-s3-bucket-name

（替换your-s3-bucket-name为你的S3存储桶，用于存放打包后的代码包）

步骤3：创建导入资源的变更集 #

通过AWS CLI创建一个导入类型的变更集，让CloudFormation关联已有Lambda资源：

aws cloudformation create-change-set \
  --stack-name my-lambda-managed-stack \ # 替换为你要创建的SAM栈名称
  --change-set-type IMPORT \
  --resources-to-import "[{\"ResourceType\":\"AWS::Lambda::Function\",\"LogicalResourceId\":\"MyExistingLambda\",\"ResourceIdentifier\":{\"FunctionName\":\"my-existing-lambda-name\"}}]" \
  --template-body file://packaged-template.yaml

说明：SAM的AWS::Serverless::Function底层对应CloudFormation的AWS::Lambda::Function，所以导入时资源类型要写后者；LogicalResourceId要和模板中定义的资源ID一致。

步骤4：执行变更集完成导入 #

登录AWS CloudFormation控制台，找到你创建的变更集，确认变更内容（会显示“导入现有资源”），执行变更集。完成后，该SAM栈就会关联你的已有Lambda函数。

步骤5：后续通过SAM管理函数 #

导入完成后，你就可以正常使用SAM CLI进行日常管理：

• 更新代码：修改本地代码后，执行sam deploy即可推送到Lambda
• 调整配置：修改模板中的属性（如环境变量、内存大小），执行sam deploy即可更新配置

你之前尝试方案的问题解析 #

1. 下载的模板无FunctionName：SAM默认会生成随机函数名称，所以直接部署会创建新函数；添加FunctionName后必须走导入流程，而非直接创建。
2. 自定义模板直接部署：未通过导入变更集告知CloudFormation要关联现有资源，CFN会尝试创建同名函数，因此报错“函数已存在”。
3. 空白栈导入：导入要求模板中必须定义对应资源的配置，空白模板没有资源定义，所以无法触发导入逻辑。

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