Spring Cloud Contract POC消费者端存根未找到问题求助

我来帮你梳理这个棘手的问题——生产者已经拿到Green-Pass说明合约生成没问题，但消费者端持续报No stubs or contracts were found，结合你提到的尝试过的配置，咱们一步步排查可能遗漏的细节：

1. 先确认生产者Stub的构建与本地仓库情况 #

• 先去生产者项目的target目录，确认是否生成了cloudcontract-producer-<版本号>-stubs.jar文件，这是合约转成Stub的核心产物。
• 执行生产者的mvn clean install（或Gradle的clean build publishToMavenLocal），把Stub包安装到本地Maven仓库（默认路径~/.m2/repository/com/datson/cloudcontract-producer/）。因为你用了StubsMode.LOCAL，StubRunner会优先从本地仓库拉取Stub，只在target目录生成但没install的话，消费者可能找不到。

2. 修正@AutoConfigureStubRunner的参数细节 #

• 你用的+是匹配最新版本，但如果本地仓库有多个版本的生产者Stub，可能会出现匹配歧义，建议明确指定版本号，比如：

  @AutoConfigureStubRunner(ids = "com.datson:cloudcontract-producer:1.0.0:8080", stubsMode = StubRunnerProperties.StubsMode.LOCAL)
  

• 如果不需要指定端口，只拉取Stub包的话，格式要确保是groupId:artifactId:version:stubs，这里的stubs是默认的classifier，除非你在生产者插件里自定义过，否则不要随便改。

3. 检查消费者的依赖配置 #

• 确认消费者的pom.xml（或build.gradle）里正确引入了Stub Runner的测试依赖，版本要和你的Spring Cloud版本匹配：

  <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-starter-contract-stub-runner</artifactId>
      <scope>test</scope>
  </dependency>
  

• 如果是Gradle，对应的依赖配置也要确保正确，且testImplementation作用域正确。

4. 验证生产者合约文件的规范 #

• 生产者的合约文件必须放在src/test/resources/contracts目录下，每个Groovy/YAML合约要符合Spring Cloud Contract的规范——比如必须包含request和response节点，语法不能出错。
• 检查生产者的Maven/Gradle插件配置，确保插件能正确扫描合约并生成Stub：

  <plugin>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-contract-maven-plugin</artifactId>
      <version>${spring-cloud-contract.version}</version>
      <extensions>true</extensions>
      <configuration>
          <!-- 如果有自定义基类，这里要配置正确 -->
          <baseClassForTests>com.datson.producer.BaseContractTest</baseClassForTests>
      </configuration>
  </plugin>
  

5. 调整StubRunner的模式尝试 #

• 如果本地仓库确认有Stub但还是找不到，可以尝试把stubsMode改成StubsMode.CLASSPATH，或者临时换成StubsMode.REMOTE（如果你的Stub已经上传到私有仓库），排查是否是本地仓库扫描的问题。

6. 消费者测试类的上下文配置 #

• 确保你的消费者测试类上除了@AutoConfigureStubRunner，还添加了合适的Spring测试注解，比如@SpringBootTest或@WebMvcTest，让Spring上下文能正确加载StubRunner的配置：

  @SpringBootTest
  @AutoConfigureStubRunner(ids = "com.datson:cloudcontract-producer:1.0.0:stubs", stubsMode = StubRunnerProperties.StubsMode.LOCAL)
  public class ConsumerContractIntegrationTest {
      // 测试逻辑
  }
  

按这个顺序排查，大概率能定位到问题——核心是确保Stub已经正确生成并被消费者的StubRunner扫描到，参数和依赖配置没有遗漏。

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