Python Lambda环境变量未加载及多阶段部署优化咨询

问题1：Lambda无法读取sam deploy传入的环境变量 #

现象 #

执行sam deploy --parameter-overrides DEBUG="true" DEV="false"部署后，CloudFormation控制台能看到参数已设置，但Lambda函数的控制台配置页环境变量为空，Python代码读取DEBUG时显示"not loaded"。

解决方案 #

问题出在SAM模板结构错误：Environment属性必须放在Lambda资源的Properties节点下，否则CloudFormation不会将参数映射为Lambda的环境变量。

正确的SAM模板示例：

Parameters:
  DEBUG:
    Type: String
    Default: "false"
  DEV:
    Type: String
    Default: "true"

Resources:
  MySampleFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: src/
      Handler: lambda_function.lambda_handler
      Runtime: python3.11
      # 关键：Environment必须嵌套在Properties内
      Environment:
        Variables:
          DEBUG: !Ref DEBUG
          DEV: !Ref DEV

重新部署后，Lambda控制台就能看到对应的环境变量，代码也能正常读取。

问题2：API Gateway多阶段部署的控制台最优方法 #

如果当前部署会替换整个API Gateway，可通过以下控制台操作实现无替换的多阶段部署：

• 创建多阶段部署：

  1. 进入API Gateway控制台，找到目标API。
  2. 左侧导航选择「部署」→「新建部署」，输入阶段名称（如dev、prod），添加描述后完成部署。
  3. 后续更新API后，选择已有的阶段重新部署，而非创建新API，这样就不会替换现有API配置。

• 阶段专属配置：
  进入对应阶段的「阶段设置」，可配置专属的阶段变量、日志级别、缓存策略等，这些变量可以传递给后端Lambda，配合SAM模板的参数实现不同阶段的差异化配置。

• 进阶优化：
  可以为不同阶段绑定自定义域名，通过域名前缀（如dev.api.example.com、prod.api.example.com）实现访问分离；也可启用API版本控制，为不同阶段关联不同的API版本，进一步隔离变更风险。

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