使用AWS SAM本地测试Lambda时，如何从本地主机复制文件？

以下是几种可行的替代方案，绕开SAM暂不支持自定义卷挂载的限制：

方案1：将测试文件放入Lambda代码目录 #

SAM本地运行时会自动把你的Lambda项目目录挂载到容器的/var/task路径下，只需把需要测试的文件放到项目目录内（比如新建test-assets文件夹），然后在Lambda代码中通过相对路径读取即可。

示例代码（Python）：

def lambda_handler(event, context):
    # 读取项目目录下test-assets文件夹中的文件
    with open("./test-assets/sample-file.txt", "r") as f:
        file_content = f.read()
    # 后续业务逻辑
    return {"statusCode": 200, "body": file_content}

运行SAM本地命令时无需额外配置，直接执行：

sam local invoke MyLambdaFunction

方案2：通过环境变量区分本地/生产逻辑 #

在代码中加入环境变量判断，本地测试时读取本地文件，生产环境正常调用S3。这种方式能最大程度贴近生产逻辑，同时兼容本地测试。

步骤：

1. 在SAM模板中为Lambda添加环境变量配置（也可在运行时临时传入）：

Resources:
  MyLambdaFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: src/
      Handler: app.lambda_handler
      Runtime: python3.11
      Environment:
        Variables:
          APP_ENV: local # 本地测试时设置，生产环境改为prod

2. 修改Lambda代码：

import os
import boto3

def lambda_handler(event, context):
    app_env = os.getenv("APP_ENV", "prod")
    
    if app_env == "local":
        # 本地测试逻辑：读取项目内的测试文件
        with open("./test-assets/sample-file.txt", "r") as f:
            content = f.read()
    else:
        # 生产逻辑：从S3读取文件
        s3_client = boto3.client("s3")
        response = s3_client.get_object(Bucket="my-production-bucket", Key="sample-file.txt")
        content = response["Body"].read().decode("utf-8")
    
    return {"statusCode": 200, "body": content}

3. 本地运行时若需临时覆盖环境变量，可使用：

sam local invoke MyLambdaFunction --env-vars env.json

其中env.json内容：

{
  "MyLambdaFunction": {
    "APP_ENV": "local"
  }
}

方案3：自定义Docker镜像挂载本地目录 #

如果需要动态挂载项目外的本地目录，可以自定义Lambda运行镜像，手动添加卷挂载逻辑：

1. 编写Dockerfile（以Python为例）：

FROM public.ecr.aws/sam/build-python3.11:latest

# 创建挂载目录
RUN mkdir /local-files
# 设置工作目录
WORKDIR /var/task

2. 构建自定义镜像：

docker build -t custom-lambda-image .

3. 在SAM模板中指定自定义镜像：

Resources:
  MyLambdaFunction:
    Type: AWS::Serverless::Function
    Properties:
      PackageType: Image
      ImageUri: custom-lambda-image:latest
      ImageConfig:
        Command: ["app.lambda_handler"]

4. 手动启动容器并挂载本地目录，再用SAM invoke连接：

# 启动自定义容器，挂载本地目录到容器的/local-files
docker run -d -v /path/to/your/local/files:/local-files --name lambda-container custom-lambda-image

# 用SAM invoke连接到运行中的容器
sam local invoke MyLambdaFunction --container-id lambda-container

这种方式适合需要频繁修改本地文件且不想每次都复制到项目目录的场景。

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