localstack可本地模拟aws服务，但需绕过vs code不识别、aws toolkit连真实云、sam cli用远程凭证三大默认假设；启动后须设aws_endpoint_url=http://localhost:4566、aws_default_region=us-east-1，并用awslocal或显式endpoint_url使s3/lambda调用指向本地，且需启用s3事件通知才能触发完整链路。
能跑，但必须绕开三个默认假设：VS Code 不自动识别 LocalStack、AWS Toolkit 默认连真实 AWS、SAM CLI 默认用远程凭证链路。 直接配完就点“Debug Locally”必失败——不是代码问题，是工具链在各自认自己的“云”。
LocalStack 启动后，AWS CLI 怎么指向它
LocalStack 启动后监听 http://localhost:4566，但 AWS CLI 默认连 https://lambda.us-east-1.amazonaws.com。不重定向，所有命令都发到真实 AWS。
- 必须显式设置环境变量：
AWS_ENDPOINT_URL=http://localhost:4566（注意末尾无斜杠） -
AWS_DEFAULT_REGION仍需设为us-east-1，LocalStack 强制要求该 region 才响应 - 不要改
AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY—— LocalStack 认任意非空值，填test即可 - 验证是否生效：运行
aws lambda list-functions --endpoint-url http://localhost:4566，返回空列表（而非报错或权限拒绝）即成功
sam local invoke 怎么不连真实 Lambda 而连 LocalStack
sam local invoke 默认启动内置 Docker 模拟器，它不走 AWS_ENDPOINT_URL，也不读本地服务——它只模拟 runtime 和 context，不模拟其他 AWS 服务调用。
- 若函数里有
boto3.client("s3")，默认会连真实 S3；要让它连 LocalStack，必须在代码中显式传endpoint_url - 正确写法：
boto3.client("s3", endpoint_url="http://host.docker.internal:4566")（Docker for Mac/Windows）或http://172.17.0.1:4566（Linux） - 别依赖
AWS_ENDPOINT_URL环境变量——sam local的容器内该变量默认为空，除非你手动--env-vars注入 - Python 用户注意：
host.docker.internal在 Linux Docker 中不可用，必须用网关 IP 或改用docker-compose自定义网络
VS Code 调试时断点不触发，是不是没连上 LocalStack
断点不触发的主因不是 LocalStack，而是 VS Code 调试器根本没加载你的 handler。常见于路径和启动方式错配。
-
launch.json中type必须是aws-sam，不能是node或python—— 后两者直接执行脚本，绕过 SAM 的容器加载逻辑 -
request必须是attach，且port要和sam local invoke --debug-port 9999一致 - handler 路径必须严格匹配文件系统结构：Node.js 写
src/handlers/index.handler，不是./src/...；Python 写app.lambda_handler，不是app.py::lambda_handler - 确保
sam build已执行——未构建的 template.yaml 里CodeUri指向源码目录，但sam local invoke实际从.aws-sam/build/加载，路径错位会导致模块找不到
如何让本地调试事件真正触发 S3/Lambda 链路
点 “Invoke Function Locally” 只是单次调用 handler，不模拟事件源（如 S3 上传）→ Lambda 触发链路。要测完整链路，得用 LocalStack 提供的触发机制。
- 先用
awslocal s3 mb s3://my-bucket创建桶（awslocal是封装了--endpoint-url的别名） - 上传文件触发 Lambda：
awslocal s3 cp test.txt s3://my-bucket/test.txt，前提是已在 LocalStack 中注册 S3 事件通知到 Lambda - 注册事件需调用
awslocal lambda create-event-source-mapping，指定EventSourceArn为arn:aws:s3:us-east-1:000000000000:my-bucket - VS Code 里无法直接调试这种异步触发——只能看
docker logs localstack或awslocal logs tail /aws/lambda/my-function查日志
最易被忽略的是：LocalStack 的 S3 事件通知默认关闭，必须启动时加 -e SERVICES=s3,lambda,cloudwatch 并确认 docker logs localstack | grep "S3 event notifications" 出现 enabled 字样。否则上传文件永远静默，连日志都不会进 Lambda。
