集成测试中LocalStack部署失败：SSM参数未找到问题排查

核心错误原因与修复步骤 #

你遇到的SSM parameter /cdk-bootstrap/hnb659fds/version not found错误，本质是Testcontainers启动的LocalStack容器与cdklocal命令的环境不匹配，或者服务未就绪就执行了操作，以下是针对性修复：

1. 强制cdklocal指向Testcontainers容器 #

Testcontainers启动的LocalStack是独立容器，必须让cdklocal命令明确使用该容器的端点，而非默认配置。在测试代码中获取容器的端点后，设置环境变量再执行命令：

# 替换为你的容器实际IP和端口（Testcontainers可通过API获取）
export AWS_ENDPOINT_URL=http://localhost:4566
export AWS_ACCESS_KEY_ID=test
export AWS_SECRET_ACCESS_KEY=test
export AWS_DEFAULT_REGION=us-east-1

# 再执行bootstrap和deploy
cdklocal bootstrap aws://test/test
cdklocal deploy --all

这里aws://test/test是LocalStack默认的账户ID和区域，确保与容器配置完全一致。

2. 等待LocalStack服务完全就绪 #

Testcontainers启动LocalStack后，SSM等服务可能需要几秒初始化，直接执行bootstrap会失败。添加健康检查逻辑：

# 等待SSM服务就绪后再执行操作
until curl -s http://localhost:4566/health | grep -q '"ssm": "running"'; do
  sleep 1
done

如果用Java/Python等Testcontainers SDK，可直接配置内置等待策略：

// Java示例：指定等待SSM服务就绪
LocalStackContainer localStack = new LocalStackContainer(DockerImageName.parse("localstack/localstack:latest"))
  .withServices(Service.SSM, Service.SQS, Service.SNS)
  .withWaitStrategy(Wait.forHttp("/health")
    .forStatusCode(200)
    .withResponsePredicate(resp -> resp.contains("\"ssm\": \"running\"")));

3. 验证bootstrap结果 #

执行cdklocal bootstrap后，可直接查询SSM参数确认是否创建成功：

awslocal ssm get-parameter --name /cdk-bootstrap/hnb659fds/version

如果能返回参数值，说明bootstrap生效，再执行deploy即可。

更优测试方案：避免命令行依赖 #

直接在测试代码中集成CDK部署逻辑，无需调用外部cdklocal命令，更稳定且易于维护：

方案1：使用LocalStack CDK测试模块 #

LocalStack提供官方测试模块，可直接在代码中部署CDK栈：

# Python示例
from localstack.testing.cdk import deploy_stack
from my_cdk_app import TestStack

def test_deploy_stack():
    # 直接部署栈到Testcontainers启动的LocalStack
    deploy_stack(TestStack)
    # 后续执行队列/主题关联的测试逻辑

方案2：Testcontainers + CDK API直接调用 #

通过CDK SDK在测试代码中初始化并部署栈，完全控制部署流程：

// Java示例
App app = new App();
TestStack stack = new TestStack(app, "TestStack");

// 配置CDK使用LocalStack端点
Map<String, String> env = new HashMap<>();
env.put("AWS_ENDPOINT_URL", localStack.getEndpointOverride(Service.SSM).toString());
env.put("AWS_ACCESS_KEY_ID", "test");
env.put("AWS_SECRET_ACCESS_KEY", "test");
stack.setEnvironment(env);

// 直接部署栈
DeploymentKit kit = DeploymentKit.of(app);
kit.deploy();

额外注意事项 #

• 确保Testcontainers使用的LocalStack版本与手动测试的版本一致，版本差异可能导致兼容性问题。
• 测试结束后添加栈销毁逻辑，避免残留资源影响后续测试：cdklocal destroy --all或通过CDK API销毁。
• 启动LocalStack时显式指定所需服务（如SSM、SQS、SNS），减少启动时间和资源占用。

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