Java17环境下Spring API引入WireMock依赖无法导入类问题

可能原因及对应解决方法 #

1. 依赖作用域限制 #

你的WireMock依赖设置了<scope>test</scope>，该依赖仅对test目录下的代码可见。如果MockServerConfig.java位于主源码目录（如src/main/java），主代码无法访问test作用域的类。

• 若该类用于测试：将其移至src/test/java目录
• 若需在主代码中使用：移除<scope>test</scope>（注意：WireMock通常仅用于测试场景，不建议生产环境使用）

2. 依赖未正确加载 #

执行Maven命令强制刷新依赖，解决可能的缓存或下载不完整问题：

mvn clean install -U

同时检查IDE依赖库，确认wiremock-standalone-2.27.2.jar已正确导入，且包含com.github.tomakehurst.wiremock.WireMockServer类。

3. 导入语句错误 #

确保类顶部添加正确的导入：

import com.github.tomakehurst.wiremock.WireMockServer;

4. 更合理的使用方式（不建议继承） #

通常无需继承WireMockServer，推荐通过实例化方式管理服务生命周期：

import com.github.tomakehurst.wiremock.WireMockServer;

public class MockServerConfig {
    private WireMockServer wireMockServer;

    public void start() {
        wireMockServer = new WireMockServer();
        wireMockServer.start();
    }

    public void stop() {
        if (wireMockServer != null) {
            wireMockServer.stop();
        }
    }
}

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