VS Code 远程部署测试 Lambda 函数需三处对齐：凭证链路（CLI 读取 ~/.aws/credentials 或 SSO）、部署路径语义（右键 template.yaml 部署整栈，右键函数节点仅更新代码）、事件触发上下文（本地调试 event 必须严格匹配真实触发源结构）。
远程部署和测试 Lambda 函数在 VS Code 里不是“配好就能跑”，关键在于三处必须对齐：凭证链路、部署路径语义、事件触发上下文。配错任意一处，就会出现“Deploy 成功但函数没更新”“Invoke 返回 200 但 handler 根本没执行”这类静默失败。
凭据必须走 CLI 链路，别在 VS Code 里手动填 AK/SK
VS Code 的 AWS Toolkit 不存密钥，只读 ~/.aws/credentials 或 SSO 配置。点了 AWS: Login 却看不到函数？先验证 CLI 是否活：
- 终端运行
aws sts get-caller-identity，能返回 ARN 才算有效 - 检查
~/.aws/credentials文件是否存在，且有命名 profile 段落，比如[prod]，段内含aws_access_key_id和aws_secret_access_key - 多账户时，VS Code 设置中必须显式指定
aws.profile，值要和 credentials 文件里的 profile 名**完全一致（大小写敏感）** - 若用 IAM Identity Center（SSO），起始 URL 必须和管理员给的一致，region 选错会导致登录成功但资源列表为空
部署时右键对象决定行为，template.yaml ≠ 函数节点
右键触发部署，目标不同，结果天差地别：
- 右键
template.yaml→Deploy Serverless Application：部署整个 SAM 应用，会创建/更新 CloudFormation 堆栈，适合首次或架构变更 - 右键 AWS Explorer 中的**具体函数名节点** →
Deploy Function：仅更新该函数代码和配置（UpdateFunctionCode+UpdateFunctionConfiguration），适合日常迭代 - 常见错误：右键 template.yaml 却以为只更新了函数，结果日志组没变、环境变量没生效——因为堆栈可能复用了旧资源
- 首次部署需指定 S3 存储桶（用于上传构建产物）和 region；后续复用时，务必确认 bucket 和 region 与上次一致，否则会部署到新区域或新建桶
本地测试 event 必须匹配真实触发源结构
调试时点 Invoke Function Locally，传的 JSON 不是随便写个 {"body": "test"} 就行。Lambda 在云上收到的 event 是由 API Gateway、S3、DynamoDB 等服务构造的完整结构体：
- API Gateway HTTP API：event 包含
rawPath、requestContext、headers，不能省略version字段（必须是"2.0"） - S3 Put 事件：必须有
Records数组，每项含s3.bucket.name和s3.object.key，字段名大小写、嵌套层级缺一不可 - 中文或特殊字符要双引号包裹、斜杠转义，否则调试器解析失败会静默退出，不报错也不停断点
- VS Code 允许保存预设事件模板（如
API Gateway - HTTP API），比手写更可靠；也可右键函数 →Edit Test Event修改后复用
远程调试依赖安全隧道，不是所有函数都默认支持
远程调试（Debug in Cloud）不是把本地 debugger 直连云端，而是通过 IoT 安全隧道 + 调试层实现。它有硬性前提：
- 函数运行时必须是支持的版本：Node.js（AL2023）、Python（AL2023）、Java —— AL2（Amazon Linux 2）及更早镜像不支持
- 函数架构必须是
x86_64或arm64，且已部署到云中（不能是本地未部署的代码） - 需要显式权限：
iot:OpenTunnel（创建隧道）、lambda:UpdateFunctionConfiguration（附加调试层）、lambda:GetLayerVersion（拉取调试层） - 调试层会在会话结束后自动移除，token 自动轮换；但每次调试前，Toolkit 都会提示你确认并重置环境变量，这个步骤跳不过
真正容易被忽略的是：远程调试不会改变函数的执行环境，它只是加了一层 attachable 的 debug agent。如果你的函数逻辑依赖 VPC 内网、特定 IAM 权限或冷启动行为，本地模拟永远无法 100% 复现——这时候远程调试不是“锦上添花”，而是唯一能定位问题的方式。
