Windows下Gradle配置特殊路径本地Maven仓库失败排查

核心排查与修复要点 #

1. Windows本地仓库URL格式错误 #

你当前的Gradle配置中，本地仓库URL的写法不符合Windows系统的解析规则。正确的格式需要使用三个斜杠，或者直接用本地路径对象，修改后的配置如下：

repositories{
  maven{
    // 写法一：标准URL格式（三个斜杠）
    url "file:///i:/ds/.m2_repo"
    // 写法二：直接使用本地路径（Gradle自动适配系统）
    // url file("i:/ds/.m2_repo")
  }
}

Gradle对Windows下的文件URL解析严格，少一个斜杠会导致路径识别失败，这是最常见的触发原因。

2. SNAPSHOT版本的仓库配置缺失 #

你的依赖通过3.3.2-SNAPSHOT版本的BOM管理，Gradle默认不会自动识别本地仓库的SNAPSHOT资源，需要明确开启SNAPSHOT支持：

repositories{
  maven{
    url file("i:/ds/.m2_repo")
    // 允许从该仓库拉取SNAPSHOT版本
    mavenContent {
      snapshotsOnly()
    }
  }
  // 若需同时使用公开仓库，可添加mavenCentral
  mavenCentral()
}

同时要确认i:\ds\.m2_repo中已正确安装me.package:my-parent:3.3.2-SNAPSHOT的POM文件，且文件内正确声明了my-starter-webmvc的版本。

3. 依赖版本传递性验证 #

错误提示Could not find me.package:my-starter-webmvc:.表明Gradle未从BOM中获取到依赖版本，可通过以下方式排查：

• 检查本地仓库中me.package:my-parent:3.3.2-SNAPSHOT.pom是否存在，且其中包含my-starter-webmvc的版本定义。
• 执行命令查看依赖树，确认BOM是否被正确导入：

./gradlew dependencies --configuration compileClasspath

4. 清理Gradle缓存 #

若存在旧缓存干扰，执行以下命令强制刷新依赖：

./gradlew clean build --refresh-dependencies

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