Karate与WireMock集成报错：找不到@ExtendWith注解求助

Karate本身基于JUnit 5运行，但它并不依赖特定的@ExtendWith注解来集成WireMock——你可以通过两种更直接的方式实现集成，同时排查服务器启动失败的问题：

方式1：直接使用WireMock原生API管理服务器 #

不需要依赖任何扩展注解，直接在测试类中通过WireMockServer对象手动启动/停止服务，并配置Stub：

import com.intuit.karate.junit5.KarateTest;
import com.github.tomakehurst.wiremock.WireMockServer;
import static com.github.tomakehurst.wiremock.client.WireMock.*;
import org.junit.jupiter.api.AfterAll;
import org.junit.jupiter.api.BeforeAll;

@KarateTest
public class WireMockIntegrationTest {

    private static WireMockServer wireMockServer;

    @BeforeAll
    static void setupWireMock() {
        // 指定端口，避免冲突；也可以不传参数用随机端口
        wireMockServer = new WireMockServer(8089);
        wireMockServer.start();
        
        // 配置接口Stub示例
        wireMockServer.stubFor(get(urlEqualTo("/api/test"))
                .willReturn(okJson("{\"code\":200,\"msg\":\"success\"}")));
        
        // 可选：将WireMock地址传入Karate配置
        System.setProperty("wiremock.base.url", "http://localhost:" + wireMockServer.port());
    }

    @AfterAll
    static void shutdownWireMock() {
        if (wireMockServer != null) {
            wireMockServer.stop();
        }
    }
}

方式2：使用WireMock官方JUnit 5扩展 #

如果你偏好注解方式，可以使用WireMock提供的WireMockExtension，配合Karate的@KarateTest即可：

1. 确保依赖正确（Maven示例） #

<!-- Karate JUnit 5依赖 -->
<dependency>
    <groupId>com.intuit.karate</groupId>
    <artifactId>karate-junit5</artifactId>
    <version>1.4.1</version>
    <scope>test</scope>
</dependency>
<!-- WireMock JUnit 5扩展依赖 -->
<dependency>
    <groupId>com.github.tomakehurst</groupId>
    <artifactId>wiremock-junit5</artifactId>
    <version>2.35.0</version>
    <scope>test</scope>
</dependency>

2. 编写测试类 #

import com.intuit.karate.junit5.KarateTest;
import com.github.tomakehurst.wiremock.junit5.WireMockExtension;
import org.junit.jupiter.api.extension.ExtendWith;
import static com.github.tomakehurst.wiremock.client.WireMock.*;

@KarateTest
@ExtendWith(WireMockExtension.class)
public class WireMockAnnotatedTest {

    // 扩展会自动管理服务器生命周期，可注入WireMockServer配置Stub
    // @BeforeEach
    // void configureStubs(WireMockServer server) {
    //     server.stubFor(post(urlEqualTo("/api/submit"))
    //             .willReturn(created()));
    // }
}

服务器启动失败排查要点 #

1. 端口冲突：检查指定的WireMock端口是否被其他进程占用，可改为随机端口（不传端口参数），再通过wireMockServer.port()动态获取地址。
2. 版本兼容：确保Karate与WireMock版本匹配，比如Karate 1.4.x可兼容WireMock 2.x/3.x版本，避免依赖冲突导致初始化失败。
3. Stub语法错误：检查WireMock的Stub配置是否符合语法规范，比如URL路径、响应格式是否正确。

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