Docker环境下Python Boto3无法连接Localstack的问题排查

错误根源 #

boto3的endpoint_url参数必须传入完整的HTTP/HTTPS格式URL，不能只填主机名Localstack-1。虽然Docker的DNS能解析这个主机名（所以ping能通），但boto3的端点校验逻辑会直接拒绝这种缺少协议和端口的格式，从而抛出ValueError: Invalid endpoint。

修复方法 #

把端点改成包含协议和Localstack服务端口的完整URL即可，Localstack默认的通用服务端口是4566，修改后的代码如下：

self.dynamodb = boto3._get_default_session().resource('dynamodb', endpoint_url='http://Localstack-1:4566')

如果你的Localstack配置了自定义端口，替换成对应的端口号即可。另外也可以通过设置环境变量AWS_ENDPOINT_URL=http://Localstack-1:4566来配置，这样boto3会自动读取这个变量，不用在代码里硬编码端点地址。

内容的提问来源于stack exchange，提问作者Jason Chan