如何在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
相关产品推荐
相关产品推荐

