搭建Spring Boot开源项目时遇Gradle插件找不到问题求助
问题原因
io.spring.ge.conventions:0.0.12是Spring内部使用的Gradle约定插件,并未发布到公开的Maven/Gradle仓库,仅托管在Spring私有仓库中。你当前处于main分支——这是项目的开发快照分支,默认配置依赖该内部插件,但你的环境没有访问Spring私有仓库的权限,因此构建时出现插件找不到的错误。
正确解决办法
按优先级选择方案:
1. 切换到稳定发布分支(最推荐)
如果只是想本地运行项目或参与贡献,直接切换到最新的稳定版本分支(比如3.1.x、2.7.x这类带版本号的分支),这些分支的构建配置依赖的都是公开可访问的插件和依赖:
git checkout 3.1.x
之后重新执行构建命令:
./gradlew build
2. 配置私有仓库访问权限(仅针对Spring官方贡献者)
如果你是Spring官方贡献者,需要给Gradle配置访问私有仓库的凭据:
- 在用户目录下创建
~/.gradle/gradle.properties文件 - 填入你的Spring私有仓库账号密码:
配置完成后重新执行springRepositoriesUsername=你的私有仓库账号 springRepositoriesPassword=你的私有仓库密码./gradlew build即可。
3. 使用官方初始化脚本
项目根目录提供了初始化构建的脚本,运行它可以自动配置必要的仓库和依赖:
./gradlew bootstrap
执行完成后再运行构建命令。
注释插件后能构建成功的原因
注释掉settings.gradle中的插件引用后,Gradle会跳过该内部插件的加载,使用默认的Gradle构建配置完成编译。但这种做法会丢失Spring官方定义的构建约定——比如代码检查规则、测试规范、依赖管理标准,长期来看会导致本地构建结果与官方CI的结果不一致,不推荐长期使用。
内容的提问来源于stack exchange,提问作者hvydya
相关产品推荐
相关产品推荐

