集成Eureka Client的StackSaga启动失败：SS-0034服务间通信验证错误

问题现象 #

集成Eureka Client的StackSaga启动失败，抛出错误：服务间通信失败[StackSaga错误码：SS-0034]

服务配置文件 #

spring.application.name=user-service
server.port=0

management.server.port=2077
management.endpoints.web.exposure.include=*

stacksaga.enable=true
stacksaga.transaction-id-prefix=us
stacksaga.app-release-version=1.0.0
stacksaga.component-scan=com.example


stacksaga.connect.admin-url=http://localhost:4444
stacksaga.connect.admin-username=user-service
stacksaga.connect.admin-password=mglMhRAHr1cEea83

错误日志 #

2023-09-26 23:12:46.591 DEBUG [user-service,,] 21992 --- [           main] .InternalServiceCommunicationCoordinator : 内部服务通信验证URL：http://192.168.8.101:9354/actuator/stacksaga/validate
2023-09-26 23:12:47.599 DEBUG [user-service,,] 21992 --- [           main] .InternalServiceCommunicationCoordinator : 内部服务通信验证URL：http://192.168.8.101:9354/actuator/stacksaga/validate
2023-09-26 23:12:48.604 DEBUG [user-service,,] 21992 --- [           main] .InternalServiceCommunicationCoordinator : 内部服务通信验证URL：http://192.168.8.101:9354/actuator/stacksaga/validate
2023-09-26 23:12:49.610 DEBUG [user-service,,] 21992 --- [           main] .InternalServiceCommunicationCoordinator : 内部服务通信验证URL：http://192.168.8.101:9354/actuator/stacksaga/validate
2023-09-26 23:12:50.620 DEBUG [user-service,,] 21992 --- [           main] .InternalServiceCommunicationCoordinator : 内部服务通信验证URL：http://192.168.8.101:9354/actuator/stacksaga/validate
2023-09-26 23:12:51.628 DEBUG [user-service,,] 21992 --- [           main] .InternalServiceCommunicationCoordinator : 内部服务通信验证URL：http://192.168.8.101:9354/actuator/stacksaga/validate
2023-09-26 23:12:52.634 DEBUG [user-service,,] 21992 --- [           main] .InternalServiceCommunicationCoordinator : 内部服务通信验证URL：http://192.168.8.101:9354/actuator/stacksaga/validate
2023-09-26 23:12:53.640 DEBUG [user-service,,] 21992 --- [           main] .InternalServiceCommunicationCoordinator : 内部服务通信验证URL：http://192.168.8.101:9354/actuator/stacksaga/validate
2023-09-26 23:12:54.645 DEBUG [user-service,,] 21992 --- [           main] .InternalServiceCommunicationCoordinator : 内部服务通信验证URL：http://192.168.8.101:9354/actuator/stacksaga/validate
2023-09-26 23:12:54.652 ERROR [user-service,,] 21992 --- [           main] o.s.cloud.config.ApplicationStartConfig : 服务间通信验证失败。
2023-09-26 23:12:54.653  WARN [user-service,,] 21992 --- [           main] ConfigServletWebServerApplicationContext : 上下文初始化期间遇到异常 - 取消刷新尝试: org.springframework.context.ApplicationContextException: Failed to start bean 'webServerStartStop'; nested exception is 
[StackSaga错误码: SS-0034]
[信息: 服务间（内部）通信验证失败。[URL: http://192.168.8.101:9354/actuator/stacksaga/validate]]
org.stacksaga.exception.InternalCommunicationFailedException: 服务间（内部）通信验证失败。[URL: http://192.168.8.101:9354/actuator/stacksaga/validate]
2023-09-26 23:12:54.669  INFO [user-service,,] 21992 --- [           main] o.apache.catalina.core.StandardService   : 停止服务 [Tomcat]

排查与解决建议 #

• 核心原因：启动时StackSaga反复尝试访问http://192.168.8.101:9354/actuator/stacksaga/validate进行内部通信验证，多次请求均失败，导致服务启动终止。
• 排查步骤：
  1. 确认IP为192.168.8.101、端口9354的目标服务是否正常启动，且StackSaga相关端点已正确暴露。
  2. 检查网络连通性：验证当前服务能否ping通目标IP，端口9354未被防火墙或安全组拦截。
  3. 核对目标服务配置：确保其management.endpoints.web.exposure.include包含stacksaga端点，管理端口配置无误。
  4. 检查Eureka注册状态：确认目标服务已成功注册到Eureka，当前服务能从Eureka获取到正确的实例信息。
  5. 验证StackSaga Admin配置：确认stacksaga.connect.admin-url指向的Admin服务正常运行，用户名密码匹配。

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