AWS SAM本地调试Python Lambda+AppConfig扩展本地模式问题排查

以下是几个关键排查和修复步骤：

• 检查本地配置文件命名规则
  确保文件名严格匹配{application-id}_{environment-id}_{configuration-profile-id}格式（使用下划线分隔，而非冒号）。比如你要访问的路径是/applications/app/environments/environment/configurations/profile，对应的文件名应该是app_environment_profile.json（JSON格式）或app_environment_profile（纯文本格式）。
  当前文件名使用冒号分隔，可能导致扩展无法识别匹配，将文件名改为下划线分隔后重试。

• 验证AppConfig扩展版本
  确保使用的AppConfig Lambda扩展版本在v1.4.0及以上，早期版本不支持本地开发模式。可以在template.yaml中指定扩展版本，示例：

  Resources:
    YourLambdaFunction:
      Type: AWS::Serverless::Function
      Properties:
        Layers:
          - !Sub arn:aws:lambda:${AWS::Region}:027400307075:layer:AWS-AppConfig-Extension:16 # 替换为对应区域的最新版本号
  

• 强制启用本地开发模式
  在template.yaml中新增环境变量AWS_APPCONFIG_EXTENSION_LOCAL_DEVELOPMENT_MODE=true，确保扩展优先读取本地配置文件，而非尝试调用云端API：

  Environment:
    Variables:
      LOCAL_DEVELOPMENT_DIRECTORY: "./appconfig"
      AWS_APPCONFIG_EXTENSION_LOCAL_DEVELOPMENT_MODE: "true"
      AWS_APPCONFIG_EXTENSION_LOG_LEVEL: "debug"
  

• 清理冲突的AWS凭证变量
  本地容器中如果存在AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY等凭证变量，AppConfig扩展可能会优先调用云端服务。测试时可移除这些变量，避免干扰本地模式。

• 检查文件权限与格式
  确认容器内AppConfig扩展进程（通常以sbx_user1051用户运行）能读取配置文件，可执行以下命令验证：

  su sbx_user1051 -c "cat /var/task/appconfig/app_environment_profile.json"
  

  同时确保JSON配置文件格式无语法错误。

• 查看扩展调试日志
  利用已设置的debug日志级别，查看扩展日志获取详细报错信息，日志路径通常为/var/log/aws/appconfig/extension.log，日志中会包含本地文件读取的过程记录。

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