本地Golang Lambda无法连接本地DynamoDB问题求助

问题现象 #

在Amazon AL2023 Docker容器中运行基于aws-sdk-go-v2的Golang Lambda，同时部署amazon/dynamodb-local。通过curl和AWS CLI可正常访问dynamodb-local，但Lambda代码调用时返回404错误：

DynamoDB: Query, https response error StatusCode: 404, RequestID: , deserialization failed, failed to decode response body, json: cannot unmarshal number into Go value of type dynamodb.protocolErrorInfo

Lambda部署到AWS环境或本地Lambda访问云端DynamoDB均正常，推测问题出在本地dynamodb-local的SDK配置上，当前使用cfg.BaseEndpoint = &endpoint设置端点。

排查与解决步骤 #

1. 确认端点格式正确性

dynamodb-local默认使用HTTP协议，端点必须包含完整的协议、主机名和端口，示例：

endpoint := "http://dynamodb-local:8000" // 主机名对应dynamodb-local容器名/服务名
cfg.BaseEndpoint = &endpoint

• 错误示例：缺失协议（dynamodb-local:8000）、缺失端口（http://dynamodb-local），都会导致SDK请求路径错误触发404。
• 验证方式：在Lambda容器内执行curl http://dynamodb-local:8000，若返回{"message":"Missing Authentication Token"}，说明端点格式有效。

2. 显式禁用SSL与签名验证

dynamodb-local不需要SSL加密和AWS签名，必须在SDK配置中关闭相关逻辑，否则会导致请求异常：

import (
    "context"
    "github.com/aws/aws-sdk-go-v2/aws"
    "github.com/aws/aws-sdk-go-v2/config"
    "github.com/aws/aws-sdk-go-v2/service/dynamodb"
)

func main() {
    cfg, err := config.LoadDefaultConfig(context.TODO(),
        config.WithRegion("us-east-1"), // 本地dynamodb-local可填任意有效区域
    )
    if err != nil {
        panic(err)
    }

    // 设置本地端点
    endpoint := "http://dynamodb-local:8000"
    cfg.BaseEndpoint = &endpoint

    // 创建DynamoDB客户端时禁用HTTPS和签名
    dynamodbClient := dynamodb.NewFromConfig(cfg, func(o *dynamodb.Options) {
        o.DisableHTTPS = true                // 关键：禁用HTTPS，匹配dynamodb-local的HTTP服务
        o.Credentials = aws.AnonymousCredentials{} // 关键：使用匿名凭证，跳过签名验证
    })

    // 后续调用dynamodbClient的方法即可
}

3. 验证Docker网络连通性

• 确保Lambda容器与dynamodb-local容器处于同一Docker网络，可通过创建专用网络实现：

  docker network create local-aws-net
  # 启动dynamodb-local
  docker run --network local-aws-net --name dynamodb-local -p 8000:8000 amazon/dynamodb-local -jar DynamoDBLocal.jar -sharedDb
  # 启动Lambda容器
  docker run --network local-aws-net --name lambda-container [你的Lambda镜像参数]
  

• 禁止在Lambda代码中使用localhost作为端点主机名，因为localhost在Lambda容器内指向自身，而非dynamodb-local容器，需使用容器名或服务名（如dynamodb-local）。

4. 开启SDK调试日志定位问题

通过开启SDK日志，查看实际请求的URL、头部和响应内容，确认请求是否符合预期：

import "log"
import "os"

// 在加载配置时添加日志模式
cfg, err := config.LoadDefaultConfig(context.TODO(),
    config.WithRegion("us-east-1"),
    config.WithClientLogMode(aws.LogRequestWithBody|aws.LogResponseWithBody),
)
// 设置日志输出到标准输出
aws.SetLogger(log.New(os.Stdout, "AWS SDK: ", log.LstdFlags))

• 若日志中显示请求URL为https://dynamodb-local:8000，说明未正确禁用HTTPS；若路径包含多余前缀，需检查端点配置。

5. 检查dynamodb-local启动参数

确保dynamodb-local未设置修改端点路径的参数，使用默认启动命令即可：

docker run -p 8000:8000 amazon/dynamodb-local -jar DynamoDBLocal.jar -sharedDb

• 若修改了端口（如-port 8001），需同步更新Lambda代码中的端点端口。

内容的提问来源于stack exchange，提问作者dann.dev