SpringBoot升级AWS SQS SDK v2后LocalStack调用ListQueues报500错误

问题根源 #

SQS Client v2默认采用REST_XML协议发起请求，但LocalStack对SQS的QUERY协议兼容性更完善。静态启动LocalStack容器时，未手动配置Client的协议模式，导致请求未携带QUERY协议必需的Action参数，触发LocalStack的操作检测失败错误。而使用@Container注解的测试容器会自动适配协议及端点配置，因此未出现问题。

具体解决方案 #

1. 强制SQS Client使用QUERY协议

初始化SqsClient时显式指定协议为QUERY，确保请求携带Action参数：

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.sqs.SqsClient;
import software.amazon.awssdk.services.sqs.SqsServiceConfiguration;
import software.amazon.awssdk.auth.credentials.AwsBasicCredentials;
import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider;
import software.amazon.awssdk.core.Protocol;
import software.amazon.awssdk.core.client.config.SdkClientConfiguration;
import java.net.URI;

public SqsClient sqsClient(LocalStackContainer localStack) {
    return SqsClient.builder()
            .endpointOverride(URI.create(localStack.getEndpointOverride(LocalStackContainer.Service.SQS).toString()))
            .credentialsProvider(StaticCredentialsProvider.create(AwsBasicCredentials.create("test", "test")))
            .region(Region.US_EAST_1)
            .serviceConfiguration(SqsServiceConfiguration.builder()
                    .protocol(Protocol.QUERY) // 关键配置：指定QUERY协议
                    .build())
            .overrideConfiguration(cfg -> cfg.signingOverride(SigningOverride.disable())) // 禁用测试环境签名验证
            .build();
}

2. 修正静态LocalStack容器启动配置

确保静态启动时明确启用SQS服务，避免容器未初始化相关处理逻辑：

import org.testcontainers.containers.localstack.LocalStackContainer;
import org.testcontainers.utility.DockerImageName;

public static final LocalStackContainer LOCAL_STACK = new LocalStackContainer(DockerImageName.parse("localstack/localstack:1.18.3"))
        .withServices(LocalStackContainer.Service.SQS)
        .withReuse(false); // 根据测试需求调整复用设置

// 在测试启动前初始化容器
static {
    LOCAL_STACK.start();
}

3. 避免硬编码端点地址

静态启动容器时，端口可能随机映射，需通过容器API获取真实端点，不要直接写http://localhost:4566：

String sqsEndpoint = LOCAL_STACK.getEndpointOverride(LocalStackContainer.Service.SQS).toString();

验证步骤 #

配置完成后调用listQueues接口，检查LocalStack日志是否不再出现Operation detection failed. Missing Action in request错误，同时确认返回的队列列表符合预期。

内容的提问来源于stack exchange，提问作者B Randall