在 Spring Boot 项目中使用 Gradle 集成 Pact 消费者测试时，若 au.com.dius.pact.consumer:junit5:4.6.1 无法正确解析，通常源于 Gradle 版本过低（低于 7.5），升级 Gradle 即可解决。

在 spring boot 项目中使用 gradle 集成 pact 消费者测试时，若 `au.com.dius.pact.consumer:junit5:4.6.1` 无法正确解析，通常源于 gradle 版本过低（低于 7.5），升级 gradle 即可解决。

Pact 是一种广泛采用的契约测试（Contract Testing）框架，用于确保消费者与提供者之间的 API 行为保持一致。在 Spring Boot 项目中，推荐使用 pact-jvm-consumer-junit5（即 au.com.dius.pact.consumer:junit5）模块进行消费者端测试。但自 Pact JVM 4.6.x 起，该库已要求 Gradle 7.5 或更高版本，因其依赖了较新的 Gradle 插件机制和 Java 17+ 兼容特性。

✅ 正确配置步骤

1. 升级 Gradle 版本
   修改项目根目录下的 gradle/wrapper/gradle-wrapper.properties 文件，将 distributionUrl 更新为 7.5+（推荐 8.2+ 以获得更好兼容性）：

   distributionUrl=https\://services.gradle.org/distributions/gradle-8.2-bin.zip

   然后执行 ./gradlew --version 验证版本生效。

   

   Spring Boot Actuator Analyzer

   分析Spring Boot Actuator端点的安全性、健康检查、指标暴露及生产配置——审计信息、健康状态和自定义端点。

   下载

2. 声明 Pact 依赖（推荐方式）
   在 build.gradle 中添加以下依赖（注意：junit5 是核心模块，无需额外引入 consumer 独立 artifact）：

   dependencies {
       testImplementation 'au.com.dius.pact.consumer:junit5:4.6.1'
       testImplementation 'org.junit.jupiter:junit-jupiter:5.10.0'
       testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine' // 如需运行测试
   }

3. 启用 JUnit 5 支持（Gradle 7.5+ 默认启用，但建议显式声明）

   test {
       useJUnitPlatform()
   }

⚠️ 注意事项

• ❌ 不要使用已废弃的 au.com.dius.pact:consumer:4.6.1（该坐标不存在，官方从未发布此 artifact）；
• ✅ 正确坐标始终为 au.com.dius.pact.consumer:junit5:{version}；
• 若使用 Spring Boot 3.x，请确保 JDK 17+ 和 Spring Boot 的 spring-boot-starter-test 与 JUnit 5 兼容；
• IDE（如 IntelliJ）可能缓存旧 Gradle 版本，升级后请执行 File → Project Structure → Project → Gradle version 同步，并点击 Reload project。

? 总结

Pact 4.6.1 的集成失败绝大多数情况下是 Gradle 版本不匹配所致。升级 Gradle 至 7.5+ 后，配合标准 junit5 依赖声明，即可顺利编译并运行 Pact 消费者测试用例。建议同步更新 IDE Gradle 插件及项目 SDK 设置，避免因环境不一致引发隐性问题。