IntelliJ中Spring Cloud Contract测试无法从类路径找到Stubs的问题求助

这个问题我之前也碰到过，本质是IntelliJ在多模块项目下的类路径优先级和Maven命令行不一致导致的——当你把生产者模块导入同一项目后，IntelliJ会默认把生产者的target/classes（主编译输出）加入消费者的类路径，而不是使用本地Maven仓库里的stubs jar；但契约定义在生产者的src/test/resources/contracts目录，这个目录的内容不会被打包到主编译输出的target/classes里，所以消费者测试找不到契约文件。

下面是几个可行的解决方案，按推荐程度排序：

1. 强制StubRunner从Maven仓库拉取Stubs（推荐） #

修改消费者的测试类上的@AutoConfigureStubRunner注解，指定stubsMode为REMOTE，并配置本地Maven仓库地址，让StubRunner优先从仓库获取stubs jar，而不是依赖本地项目的类路径：

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.NONE)
@AutoConfigureStubRunner(
    ids = "com.sample:rest-producer:+:stubs:8080",
    stubsMode = StubRunnerProperties.StubsMode.REMOTE,
    mavenRepo = "file:///Users/adam/.m2/repository"
)
class DocumentReaderIntTest {
    // 你的测试代码
}

这样配置后，不管IntelliJ怎么处理模块依赖，StubRunner都会直接去你指定的本地Maven仓库找打包好的stubs jar，完全规避类路径冲突的问题。

2. 调整IntelliJ的模块依赖配置 #

打开IntelliJ的Project Structure（快捷键Cmd+;或Ctrl+Alt+Shift+S）：

• 找到消费者模块的Dependencies列表
• 找到生产者模块的依赖项，把它的Scope改成Test，或者直接移除这个模块依赖（因为你已经在pom.xml里引入了stubs的Maven依赖）
• 点击Apply保存配置

这个方法让IntelliJ不再把生产者的主编译输出加入消费者的类路径，而是使用Maven仓库里的stubs jar。不过需要注意，如果你后续修改了生产者代码，需要重新执行mvn clean install更新仓库里的stubs jar才能生效。

3. 临时方案：把契约文件打包到生产者主jar（不推荐） #

如果你只是临时测试，可以修改生产者的pom.xml，把测试目录下的契约文件打包到主jar的资源目录里。但这个方法会把测试资源混入生产代码，不适合正式环境：

<build>
    <resources>
        <resource>
            <directory>src/test/resources/contracts</directory>
            <includes>
                <include>**/*.groovy</include>
            </includes>
        </resource>
    </resources>
</build>

修改后执行mvn clean install，生产者的target/classes里就会包含契约文件，消费者用项目模块类路径时也能找到。

4. 刷新IntelliJ的Maven依赖 #

有时候IntelliJ没有及时同步Maven依赖，导致它优先使用模块编译输出而不是仓库里的stubs jar。你可以：

• 右键消费者模块 → Maven → Reload Project
• 或者点击IntelliJ右侧Maven面板里的刷新按钮

这个方法适合那些依赖同步延迟的情况，配合前面的方案一起用效果更好。

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