goland调试go lambda需同步实现调试器接管与sdk请求打到localstack：启动localstack须暴露4566端口并设localstack_host=localhost；go代码须区分本地/lambda模式，本地用lambda.starthandler+自定义事件并硬编码endpoint="http://localhost:4566"、use_path_style=true；goland run configuration须显式配置aws_endpoint_url、aws_region等环境变量。
GoLand 里配 LocalStack 调试 Go Lambda，关键不是“连上 LocalStack”，而是让 Go 程序在本地运行时，能被 GoLand 的调试器接管，同时把 AWS SDK 的请求打到 LocalStack 上——这两件事必须同步生效，缺一不可。
启动 LocalStack 时必须暴露调试所需端口
LocalStack 默认只暴露 4566（Lambda API）和 4567（S3），但 GoLand 调试依赖 Delve 的 dlv 监听端口（比如 2345）。如果你用 docker-compose.yml 启动，得显式加 ports 并确保容器网络互通：
- LocalStack 容器必须监听
0.0.0.0:4566（不能只绑127.0.0.1），否则 Go 程序从宿主机访问会失败 - 如果后续要调试 Go 服务本身（非 Lambda handler），需额外映射
2345:2345并在容器内运行dlv，但绝大多数情况你只需调试本地 Go Lambda 主程序，所以这步可跳过 - 确认
LOCALSTACK_HOST环境变量设为localhost（不是localstack），因为 Go 程序运行在宿主机，DNS 解析不到容器名
Go 代码里区分本地与 Lambda 运行模式
LocalStack 模拟的是 Lambda 运行时行为，但你的 Go 程序在 GoLand 里是以普通进程启动的。所以必须手动判断环境，避免直接调 lambda.Start 导致阻塞或 panic：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 检查
os.Getenv("AWS_LAMBDA_RUNTIME_API")是否为空：为空 → 本地模式；非空 → Lambda 模式 - 本地模式下，用
lambda.StartHandler+ 自定义事件输入（比如从 JSON 文件读取或硬编码），不要用lambda.Start - 务必在初始化 AWS SDK 时覆盖 endpoint：
endpoint := "http://localhost:4566"，并设置use_path_style: true（尤其对 S3） - 示例片段：
if os.Getenv("AWS_LAMBDA_RUNTIME_API") == "" { // 本地调试入口 event := loadTestEvent("test-event.json") lambda.StartHandler(handler).Invoke(context.Background(), event) } else { // Lambda 真实入口 lambda.Start(handler) }
GoLand 的 Run Configuration 必须注入 LocalStack 环境变量
GoLand 不会自动继承 shell 里的环境变量，AWS_ENDPOINT_URL、AWS_REGION 这些必须显式填进 Run Configuration，否则 SDK 仍会发往真实 AWS：
- 打开
Run → Edit Configurations…，选中你的 Go 程序配置 - 在
Environment variables栏添加：AWS_ENDPOINT_URL=http://localhost:4566、AWS_REGION=us-east-1、AWS_ACCESS_KEY_ID=test、AWS_SECRET_ACCESS_KEY=test - 注意：
AWS_ENDPOINT_URL是 SDK v2 的标准变量；v1 需用AWS_ENDPOINT，别混用 - 勾选
Include system environment variables可省去部分重复设置，但别依赖它——LocalStack 相关变量必须明确写出
调试时常见连接失败原因
GoLand 显示 “connection refused” 或 handler 根本没进断点，90% 出在以下三点：
- LocalStack 容器没真正启动成功：执行
docker ps看localstack/localstack容器状态，再curl http://localhost:4566/health确认返回{"services":{...}} - Go 程序里初始化 S3 client 时漏了
UsePathStyle: aws.Bool(true)，导致 S3 请求路径错成bucket.s3.us-east-1.localhost:4566（DNS 解析失败） - GoLand 的 Go SDK 配置用了旧版 Go（File → Project Structure → SDKs 版本
最易忽略的是：LocalStack 的 Lambda service 默认不启用 —— 即使你在 docker-compose.yml 里写了 LAMBDA_EXECUTOR=docker-reuse，也得确认 services 列表里真包含 lambda，且没有拼错成 lamba 这类低级错误。跑通第一请求前，先用 aws --endpoint-url=http://localhost:4566 lambda list-functions 手动验证通路，比盲调代码快得多。
