使用环境变量配置AWS CLI指向Localstack自定义端点遇错求助

你遇到的问题核心是AWS CLI版本不同，对应的端点环境变量格式不一致，导致请求未正确路由到Localstack，反而发到了真实AWS服务，因此出现密钥无效的错误。

分版本解决方案 #

1. 若使用AWS CLI v1 #

v1不支持全局AWS_ENDPOINT_URL变量，也不兼容AWS_ENDPOINT_URL_S3这类格式，必须遵循AWS_<服务名>_ENDPOINT_URL的命名规则设置：

AWS_ACCESS_KEY_ID=test AWS_SECRET_ACCESS_KEY=test AWS_S3_ENDPOINT_URL=http://localhost:4566 AWS_STS_ENDPOINT_URL=http://localhost:4566 AWS_DEFAULT_REGION=us-east-1 aws s3 ls

• 每个需要调用的服务都要单独设置对应变量，比如S3、STS、EC2等；
• 必须指定AWS_DEFAULT_REGION=us-east-1，Localstack默认兼容该区域，部分服务依赖区域配置才能正常运行。

2. 若使用AWS CLI v2 #

v2支持全局AWS_ENDPOINT_URL和服务特定的AWS_ENDPOINT_URL_<服务>变量，若之前尝试无效，可排查以下点：

• 本地AWS配置文件（~/.aws/config或~/.aws/credentials）优先级高于环境变量，可添加参数强制忽略本地配置测试：

  AWS_ACCESS_KEY_ID=test AWS_SECRET_ACCESS_KEY=test AWS_ENDPOINT_URL=http://localhost:4566 AWS_DEFAULT_REGION=us-east-1 aws s3 ls --no-sign-request
  

• 检查是否有AWS_PROFILE等冲突环境变量生效，这类变量会覆盖端点设置。

额外简化方案：使用Localstack官方工具 #

Localstack提供awslocal工具（通过pip install localstack安装），可自动配置所有必要环境变量，直接替代aws命令即可：

awslocal s3 ls

内容的提问来源于stack exchange，提问作者Héctor Valls