如何使用AWS Java SDK v2为KMS配置LocalStackContainer及端点覆盖？

核心问题 #

LocalStack启动后才会生成动态专属端点，但你的KMSClient需要在它启动前完成初始化，核心矛盾是「静态初始化时机」和「动态端点」不匹配，以下是几种可行的解决方式：

具体方案 #

方案1：调整初始化时机（最直接） #

如果代码允许修改，优先把KMSClient的实例化放在LocalStack启动之后，直接获取它的动态KMS端点：

// 先启动LocalStack并指定KMS服务
LocalStackContainer localStack = new LocalStackContainer(
        DockerImageName.parse("localstack/localstack:2.3.0")
    ).withServices(LocalStackContainer.Service.KMS);
localStack.start();

// 用LocalStack的动态端点初始化KMSClient
KmsClient kmsClient = KmsClient.builder()
        .endpointOverride(URI.create(localStack.getEndpointOverride(LocalStackContainer.Service.KMS)))
        // LocalStack不需要真实AWS凭证，填格式合法的测试凭证即可
        .credentialsProvider(StaticCredentialsProvider.create(AwsBasicCredentials.create("test", "test")))
        .region(Region.of(localStack.getRegion()))
        .build();

方案2：延迟加载KMSClient（适配必须提前初始化的场景） #

如果业务逻辑要求必须提前声明客户端实例，可以用**供应商模式（Supplier）**延迟创建实际的KMSClient对象：

// 提前定义一个延迟创建的供应商，不立即实例化客户端
Supplier<KmsClient> kmsClientSupplier = () -> {
    // 此处确保LocalStack已经启动，直接获取已启动容器的实例
    LocalStackContainer localStack = // 注入或引用已启动的LocalStack实例
    return KmsClient.builder()
            .endpointOverride(URI.create(localStack.getEndpointOverride(LocalStackContainer.Service.KMS)))
            .credentialsProvider(StaticCredentialsProvider.create(AwsBasicCredentials.create("test", "test")))
            .region(Region.of(localStack.getRegion()))
            .build();
};

// 业务代码需要使用KMSClient时，再调用get()触发实际初始化
KmsClient kmsClient = kmsClientSupplier.get();

方案3：依赖注入场景下用懒加载 #

如果使用Spring等依赖注入框架，给KMSClient的Bean加上@Lazy注解，让它在第一次被使用时才初始化，此时LocalStack已经启动完成：

@Bean
@Lazy
public KmsClient kmsClient(LocalStackContainer localStack) {
    return KmsClient.builder()
            .endpointOverride(URI.create(localStack.getEndpointOverride(LocalStackContainer.Service.KMS)))
            .credentialsProvider(StaticCredentialsProvider.create(AwsBasicCredentials.create("test", "test")))
            .region(Region.of(localStack.getRegion()))
            .build();
}

关键注意事项 #

• LocalStack不验证真实AWS凭证，但KMSClient要求必须提供格式合法的凭证，所以用静态测试凭证即可
• 调用getEndpointOverride前必须确保LocalStack容器处于启动状态，否则会获取到无效端点

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