LocalStack不是透明代理，需禁用签名、设region为us-east-1、启用path-style endpoint，并注意Lambda容器环境、S3桶名规范及DynamoDB状态延迟。
能跑，但必须绕开 AWS CLI 和 SDK 的默认行为——LocalStack 不是“换 endpoint 就完事”的透明代理，它会拒绝未签名请求、不认 IAM 角色、对 region 和 use_path_style_endpoint 敏感。
LocalStack 启动后，AWS SDK 调用直接报 403 或 Connection refused
根本原因不是端口没开，而是 SDK 默认走签名流程，而 LocalStack 的 http://localhost:4566 不接受带签名的请求（除非你显式启用 PROVIDER_OVERRIDE），也不处理 IAM role 自动注入逻辑。
- Python boto3：必须显式禁用签名，加
config=Config(signature_version=UNSIGNED)，且region必须设为us-east-1（LocalStack 默认只响应这个 region） - Node.js @aws-sdk/client-s3：在 client 构造时传
{ credentials: { accessKeyId: 'test', secretAccessKey: 'test' }, region: 'us-east-1', endpoint: 'http://localhost:4566', forcePathStyle: true }，forcePathStyle不能省，否则 S3 操作 404 - PHP AWS SDK：
'signature_version' => 'unsigned'必须写进 client 配置，'use_path_style_endpoint' => true同样关键，否则 SQS/SNS 请求路由失败
VSCode 中调试 Lambda 函数时，本地调用总提示 “No response from Lambda”
LocalStack 的 Lambda 模拟器不复用 AWS 的 runtime 环境，它用的是 Docker 容器拉起真实 Amazon Linux 镜像，所以你的 handler 代码路径、依赖打包方式、甚至 /tmp 权限都得和线上一致——否则容器内根本 load 不起函数。
- 确保
sam build时指定--use-container，否则本地构建的层可能缺失 libc 或 node-gyp 编译产物 - handler 入口格式必须严格匹配：Python 是
app.handler（不是app.py::handler），Node.js 是src/index.handler（不能带./前缀） - LocalStack 默认把 Lambda 日志输出到控制台，不是 CloudWatch；想看完整日志，启动时加
-d参数或查docker logs localstack_main
template.yaml 里引用了 S3 Bucket，本地部署却卡在 “ResourceNotReady”
CloudFormation 模板里的 AWS::S3::Bucket 资源在 LocalStack 中创建极快，但如果你模板里写了 DependsOn 或用了 !GetAtt Bucket.Arn，而 bucket 名含非法字符（如下划线）、或 region 不匹配，LocalStack 会静默失败，不抛错也不继续。
- bucket 名只能含小写字母、数字、连字符，且不能以连字符开头或结尾——
my-test-bucket✅，my_test_bucket❌ - 所有资源声明的
region必须统一为us-east-1，哪怕你在 VSCode 设置里改了默认 region，LocalStack 只认这个 - 首次部署前手动执行
aws --endpoint-url=http://localhost:4566 s3 mb s3://my-test-bucket，确认 bucket 真的存在，再跑sam deploy
最易被忽略的一点：LocalStack 的 DynamoDB 表名区分大小写，但它的 ListTables 返回结果默认不包含刚创建的表——要等几秒再查，或者加 --no-verify-ssl 参数避免因证书问题中断连接。这不是 bug，是模拟器内部状态同步延迟导致的。
