You need to enable JavaScript to run this app. 如何在SpringBootTest中启动跨模块SpringBoot服务以通过Maven测试
优惠活动
大模型
产品
解决方案
定价
更多

如何在SpringBootTest中启动跨模块SpringBoot服务以通过Maven测试

问题根因
  • 你当前的测试基类AbstractTestDefinition只加载了karate模块自身的KarateContextConfiguration配置,完全没有关联local-server模块的StartLocalServer启动类,因此@SpringBootTest注解根本不会触发服务端程序的启动流程,测试过程中本地8080端口是完全空闲的,自然会抛HttpHostConnectException连接拒绝异常。
  • 手动启动服务时之所以测试全过,是因为你手动启动的local-server实例占据了8080端口,测试请求可以正常连通;但执行mvn clean install全量构建时,流程只会按模块顺序编译打包,不会主动拉起local-server的运行实例,就出现了测试全挂的情况。
  • 你日志里看到的prod配置激活、线程池初始化,其实只是karate测试自身的Spring上下文初始化,和真正的local-server服务启动完全没有关系。
可直接落地的配置步骤

1. 修正测试类的上下文加载规则

将原有测试基类的配置直接指向local-server模块的启动类,移除当前模块单独加载的无效配置:

// 删除原@ContextConfiguration(classes = {KarateContextConfiguration.class})注解
@SpringBootTest(
  classes = StartLocalServer.class,
  webEnvironment = SpringBootTest.WebEnvironment.DEFINED_PORT,
  properties = "spring.profiles.active=test"
)
public class AbstractTestDefinition {
}

重点提醒:

  • 必须将webEnvironment设置为DEFINED_PORT,不要使用默认的随机端口模式。否则SpringBootTest会给启动的服务分配随机端口,和你karate用例里写死的localhost:8080地址不匹配,依然会报连接错误。
  • 要确保karate模块的pom.xml中已经添加local-server模块的测试依赖,否则类路径下找不到StartLocalServer类会启动失败:
<dependency>
  <groupId>你的项目groupId</groupId>
  <artifactId>local-server</artifactId>
  <version>你的项目版本号</version>
  <scope>test</scope>
</dependency>

2. 补齐测试环境配置

在karate模块的src/test/resources路径下新建application-test.yml,将服务启动需要的数据库连接、端口配置、组件开关等调整为测试专用的参数,避免生产环境的prod配置干扰测试启动。

3. 调整完成后的运行效果

  • 执行mvn clean install时,流程会自动在测试运行的同JVM内加载StartLocalServer的完整配置,绑定8080端口完成服务启动,等Spring上下文完全就绪后才会触发karate测试用例执行。
  • 服务的生命周期和测试流程完全绑定,所有测试执行完成后会自动销毁Spring上下文、关闭8080端口,不会残留后台进程占用端口,完全不需要手动干预。
  • 不需要再手动提前启动本地服务,全量构建的测试流程可以一键跑通。

不推荐新手使用的替代方案:如果坚持要将服务和测试跑在独立JVM中,可以配置exec-maven-plugin在测试执行前通过命令行启动local-server的jar包,等8080端口连通后再执行karate测试,测试完成后自动杀掉服务进程。但这种方案涉及进程管理、端口探活等额外逻辑,排查问题的成本很高,新手优先使用上面的同JVM启动方案即可。


内容的提问来源于stack exchange,提问作者user13689608

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.19 16:54:07