如何在Spring Boot中通过环境变量配置SQS端点？

方案1：自定义配置类读取环境变量 #

直接修改你的配置类，通过Spring的环境变量注入逻辑，动态判断是否设置LocalStack端点，AWS环境下自动使用默认端点：

@Configuration
public class SQSClientConfig {

    // 读取环境变量，默认值为null（不设置端点）
    @Value("${aws.sqs.endpoint:#{null}}")
    private String sqsEndpoint;

    @Bean
    public SqsMessageListenerContainerFactory<Object> defaultSqsListenerContainerFactory() {
        return SqsMessageListenerContainerFactory
                .builder()
                .sqsAsyncClient(sqsAsyncClient())
                .build();
    }

    @Bean
    public SqsAsyncClient sqsAsyncClient() {
        var credentials = EnvironmentVariableCredentialsProvider.create();
        var clientBuilder = SqsAsyncClient.builder()
                .credentialsProvider(credentials)
                .region(DefaultAwsRegionProviderChain.builder().build().getRegion());

        // 仅当环境变量存在时，设置LocalStack端点
        if (sqsEndpoint != null && !sqsEndpoint.isEmpty()) {
            clientBuilder.endpointOverride(URI.create(sqsEndpoint));
        }

        return clientBuilder.build();
    }

    @Bean
    public Listener listener() {
        return new Listener();
    }
}

使用方式：

• 本地测试：设置环境变量 aws.sqs.endpoint=http://localhost:4566，可以通过IDE运行配置、Docker Compose或启动命令添加：

  export aws.sqs.endpoint=http://localhost:4566 && java -jar your-app.jar
  

• AWS部署：不设置该环境变量，SQS客户端会自动根据配置的region匹配AWS官方端点（如sqs.us-east-2.amazonaws.com）。

方案2：使用Spring Cloud AWS自动配置（更简洁） #

如果项目引入Spring Cloud AWS依赖，可直接通过配置文件/环境变量完成配置，无需自定义SqsAsyncClient Bean：

1. 添加Maven依赖：

<dependency>
    <groupId>io.awspring.cloud</groupId>
    <artifactId>spring-cloud-starter-aws-sqs</artifactId>
</dependency>

2. 配置环境变量：

• 本地环境：

  cloud.aws.sqs.endpoint=http://localhost:4566
  cloud.aws.region.static=us-east-2
  

• AWS环境：无需设置cloud.aws.sqs.endpoint，框架会自动通过IAM角色/凭证链获取权限并匹配默认端点。

注意事项 #

• LocalStack测试时，需设置任意非空的AWS凭证环境变量（如AWS_ACCESS_KEY_ID=test、AWS_SECRET_ACCESS_KEY=test）；
• AWS部署时，确保容器拥有对应SQS权限的IAM角色（如ECS任务角色），无需手动配置凭证。

内容的提问来源于stack exchange，提问作者Eduardo Lopes