配置commercetools SDK v2执行gradlew bootRun时依赖缺失求助

问题重现 #

在路径 D:\toolsv2\commercetools-sdk-v2\examples\spring 执行 gradlew bootRun，构建直接失败，核心报错：

Task :compileJava FAILED
无法解析配置':compileClasspath'的所有文件，找不到com.commercetools.sdk:commercetools-sdk-java-api:17.1.0-SNAPSHOT和com.commercetools.sdk:commercetools-okhttp-client3:17.1.0-SNAPSHOT这两个依赖包。

修改gradlew.wrapper.properties中的Gradle版本后问题依旧。

解决方案 #

1. 本地构建SDK快照依赖 #

17.1.0-SNAPSHOT是未正式发布的快照版本，公共Maven仓库不会提供该版本，必须从源码构建到本地仓库：

• 切换到commercetools-sdk-v2的根目录：cd D:\toolsv2\commercetools-sdk-v2
• 执行构建并发布到本地Maven仓库：gradlew publishToMavenLocal
• 回到spring示例目录，重新执行gradlew bootRun

2. 确保示例项目配置了本地仓库 #

检查spring示例项目的build.gradle文件，确认仓库列表中包含mavenLocal()，这样Gradle才会优先从本地仓库查找快照依赖：

repositories {
    mavenLocal()
    mavenCentral()
    // 其他必要仓库
}

3. 清理Gradle缓存并强制刷新依赖 #

如果存在缓存冲突，执行以下命令清除旧缓存并重新构建：

gradlew clean build --refresh-dependencies

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