AWS SAM Local本地测试：通过环境变量配置Lambda访问主机服务

我来帮你搞定这个问题！SAM Local其实有好几套成熟的方案来处理本地测试时的环境变量配置，完美解决你遇到的IP变更、多人协作场景下的痛点：

你可以在SAM模板的Lambda函数资源里，专门为本地测试添加环境变量配置。SAM Local在运行时会自动加载这些变量，而部署到AWS云端时，你可以通过参数或者不同的配置文件轻松覆盖。

比如在你的template.yaml里：

Resources:
  MyLambdaFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: ./src
      Handler: app.lambda_handler
      Runtime: python3.9
      Environment:
        Variables:
          REST_API_HOST: "192.168.1.100"  # 填入你的本地Mock服务IP/主机名
          REST_API_PORT: "8080"

如果需要临时修改IP不用改模板，直接用命令行参数覆盖：

sam local invoke MyLambdaFunction --parameter-overrides ParameterKey=RestApiHost,ParameterValue=192.168.1.101

（注：这种方式需要先在模板里定义对应的参数，适合相对固定的本地测试场景）

SAM Local支持自动加载项目根目录下的.env文件，这是最适合多人协作和IP频繁变更的方式——你可以把本地专属的配置放在这个文件里，不用修改SAM模板，还能把它加入.gitignore避免提交到版本控制。

1. 在项目根目录创建.env文件，内容如下：

REST_API_HOST=192.168.1.100
REST_API_PORT=8080

2. 在SAM模板的Lambda函数环境变量中引用这些变量：

Resources:
  MyLambdaFunction:
    Type: AWS::Serverless::Function
    Properties:
      # ...其他配置项
      Environment:
        Variables:
          REST_API_HOST: ${env:REST_API_HOST}
          REST_API_PORT: ${env:REST_API_PORT}

3. 正常运行SAM Local命令即可，它会自动读取.env里的变量。其他开发者只需要创建自己的.env文件填入自己的本地Mock服务地址，完全不影响代码和模板。

如果你需要多套本地配置（比如测试不同版本的Mock服务），可以用--env-vars参数指定一个JSON配置文件，灵活切换环境。

1. 创建local-env.json文件：

{
  "MyLambdaFunction": {
    "REST_API_HOST": "192.168.1.100",
    "REST_API_PORT": "8080"
  }
}

2. 运行SAM Local时指定这个文件：

# 测试单个Lambda函数
sam local invoke MyLambdaFunction --env-vars local-env.json

# 启动本地API网关测试
sam local start-api --env-vars local-env.json

这种方式适合复杂的本地测试场景，比如需要快速切换不同的Mock服务地址。

最后提醒下，Lambda函数里读取环境变量的方式要统一，比如Python里用os.environ['REST_API_HOST']，这样不管是本地测试还是云端部署都能正常工作。

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