GCP Artifact Registry 拉取Gradle自定义插件失败问题咨询
问题根因
你碰到的两个报错,本质是配置顺序和执行时机不匹配导致的两个错位:
- Gradle 对插件id的版本解析完全由
settings.gradle.kts内的pluginManagement配置管控,build.gradle.kts中的buildscript仓库配置不参与plugins {}块的插件解析流程。之前把Artifact Registry仓库配在build文件里,根本没被插件解析环节用到,自然只会去Gradle官方插件中心搜索。 artifactregistry://是第三方插件注入的自定义仓库协议,不是Gradle原生支持的格式。在Artifact Registry官方Gradle插件还没加载完成的执行节点,直接配置这个协议的仓库地址,Gradle原生的协议校验逻辑就会直接抛出“不支持的协议”错误。本地Maven仓库拉取正常,是因为file协议是Gradle原生支持的,不存在协议识别的问题,不代表Artifact Registry侧的配置没有问题。
正确配置方案
调整 settings.gradle.kts 核心配置
推荐直接使用Gradle原生支持的HTTPS协议指向Artifact Registry仓库,完全绕开自定义协议的加载时机问题,配置示例如下:
pluginManagement { repositories { // 用HTTPS地址指向Artifact Registry仓库,Gradle原生支持该协议,无需依赖第三方插件即可识别 maven(url = uri("https://us-west1-maven.pkg.dev/glitchy-maven/repo")) // 保留Gradle官方插件源,用于拉取公共插件依赖 gradlePluginPortal() } plugins { // 声明Artifact Registry官方插件,确保后续常规依赖场景下能正常使用自定义协议拉取构件 id("com.google.cloud.artifactregistry.gradle-plugin") version "2.1.1" // 声明自定义插件,Gradle会自动在上述仓库列表中检索对应插件的标记构件 id("com.glitchybyte.gradle.plugin.buildinfo") version "1.0.0" } }
如果坚持要使用artifactregistry://自定义协议拉取插件,需要调整仓库的添加时机:等Artifact Registry插件加载完成后,再添加对应自定义协议的仓库地址,避免提前触发协议校验报错。
校验插件发布的合规性
Gradle通过插件id拉取构件时,会优先查找插件对应的标记构件,也就是遵循${插件id}:${插件id}.gradle.plugin:${插件版本}的坐标规则定位POM文件。你需要确认Artifact Registry仓库内存在对应文件:
- 文件路径:
com/glitchybyte/gradle/plugin/buildinfo/com.glitchybyte.gradle.plugin.buildinfo.gradle.plugin/1.0.0/com.glitchybyte.gradle.plugin.buildinfo.gradle.plugin-1.0.0.pom - POM文件内的依赖配置需要正确指向你实际编译生成的插件jar的坐标。
如果缺少这个标记文件,就算仓库配置完全正确,Gradle也无法通过插件id定位到实际的插件jar。
常见踩坑提醒
- 不要在
build.gradle.kts的buildscript块里配置插件解析仓库:该块的加载时机晚于插件解析流程,配置不会生效。 - 不要在第三方协议未注入的场景下提前配置自定义协议仓库:
artifactregistry://的协议识别逻辑完全依赖对应插件的加载,提前配置必然触发协议校验错误。 - 手动发布插件时不要遗漏标记构件:如果使用纯手动方式上传插件文件,没有通过
java-gradle-plugin插件自动生成对应的marker POM,会直接导致插件找不到。
内容的提问来源于stack exchange,提问作者Luis
相关产品推荐
相关产品推荐

