运行AWS SAM Local start-api时，如何指定模板参数文件？

好问题！SAM Local本地运行时确实没有直接对应aws cloudformation deploy中参数文件的专属参数，但有几个实用的办法来模拟这个需求：

1. 直接在命令行传递参数覆盖值 #

sam local start-api支持--parameter-overrides参数，用法和CloudFormation的同名参数完全一致，直接把参数键值对以空格分隔传入即可：

sam local start-api --parameter-overrides "ApiKey=my-local-test-key Environment=dev DatabaseUrl=localhost:5432"

模板里所有用!Ref ApiKey、!Sub ${Environment}这类方式引用参数的地方，都会自动替换成你指定的值。

2. 用环境变量文件模拟参数（适合Lambda运行时场景） #

如果你的参数主要是给Lambda函数提供运行时配置，可以先在SAM模板里把参数映射为函数的环境变量，再用SAM Local的--env-vars参数传递本地测试值：
首先在模板中定义函数的环境变量关联：

Resources:
  MyApiFunction:
    Type: AWS::Serverless::Function
    Properties:
      Runtime: python3.11
      Environment:
        Variables:
          API_KEY: !Ref ApiKey
          APP_ENV: !Ref Environment

然后创建一个本地环境变量文件（比如local-env.json）：

{
  "MyApiFunction": {
    "API_KEY": "my-local-api-key-123",
    "APP_ENV": "local-test"
  }
}

启动本地API时指定这个文件：

sam local start-api --env-vars local-env.json

这样Lambda函数就能在本地运行时拿到这些模拟的参数值了。

3. 利用SAM配置文件复用部署参数 #

如果你已经通过sam deploy --guided生成了samconfig.toml配置文件，里面保存了部署时的参数设置，SAM Local可以直接读取这个文件里的参数：

sam local start-api --config-env default

这里的default是配置文件里的环境名，SAM会自动加载对应环境下的参数覆盖值，不用每次手动输入参数。

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