SpringBootTest在CI服务器无法启动SQS容器但本地正常的排查求助

先把核心问题明确：本地执行mvn clean test时测试完全正常，但到CI环境中，Tomcat启动后Spring上下文初始化失败，报错：

org.springframework.context.ApplicationContextException: Failed to start bean 'io.awspring.cloud.messaging.internalEndpointRegistryBeanName'

结合你用LocalStack模拟SQS的场景，按以下步骤逐步缩小排查范围：

1. 验证CI环境中LocalStack的启动状态 #

• 检查CI构建脚本里，LocalStack是不是在测试开始前就完全启动就绪了。本地机器资源充足启动快，但CI环境可能资源有限，很可能测试已经开始了，LocalStack还没初始化好。
• 给CI脚本加个等待逻辑，比如循环调用curl http://localhost:4566/health，直到返回成功状态；或者用LocalStack官方的等待工具来确保服务就绪。
• 确认LocalStack启动命令里指定了SQS服务，比如有没有加SERVICES=sqs（或者用SERVICES=all），别漏开了SQS服务。

2. 核对CI与本地的Spring配置差异 #

• 检查测试用的配置文件（比如application-test.yml）在CI环境有没有正确加载，会不会有CI专属的配置把本地的SQS配置覆盖了。
• 重点盯SQS端点配置：确认CI里spring.cloud.aws.sqs.endpoint是不是指向LocalStack的正确地址（一般是http://localhost:4566），别不小心用了生产环境的AWS真实端点。
• 检查AWS认证配置：LocalStack不需要真实密钥，但有些版本的awspring-cloud要求配置占位符密钥，确认CI环境里spring.cloud.aws.credentials.access-key和secret-key有没有设成非空值（比如填test/test就行）。

3. 扒完整的异常堆栈找根因 #

• 现在的报错只是顶层的上下文启动失败，得看完整的异常栈，找到导致internalEndpointRegistryBeanName启动失败的真正原因。
• 在CI的构建日志里搜Caused by:开头的内容，通常这里会指向具体问题，比如SQS连不上超时、队列不存在、权限配置错了之类的。

4. 检查测试类的SQS初始化逻辑 #

• 看看SqsIntegrationTestSupport接口里有没有创建SQS队列的逻辑，确认CI环境里这段逻辑是不是执行成功了——比如有没有在测试前调用AmazonSQSClient创建队列，有没有抛出异常没被捕获。
• 确认基类AbstractPostgresJupiterTest的初始化逻辑会不会和SQS测试逻辑冲突，比如有没有异步初始化的Bean打乱了SQS相关Bean的启动顺序。

5. 核对CI与本地的依赖、环境版本 #

• 确认CI用的Maven版本、JDK版本和本地完全一致，别因为版本差导致依赖加载或者兼容性问题。
• 在CI脚本里加个mvn dependency:tree命令，把CI的依赖树和本地的对比一下，确保awspring-cloud、LocalStack相关依赖的版本完全一样。

6. 给CI测试加调试日志 #

• 在CI的测试命令里加日志级别参数，比如：

  mvn clean test -Dlogging.level.io.awspring.cloud=DEBUG -Dlogging.level.org.springframework.cloud=DEBUG
  

  这样能拿到更详细的SQS相关Bean启动日志，精准定位是哪个EndpointRegistry Bean启动失败，以及具体失败原因。

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