无法解析org.asciidoctor.convert:2.2.1插件问题求助

问题本质 #

报错核心是Gradle在配置的仓库里找不到org.asciidoctor.convert:org.asciidoctor.convert.gradle.plugin:2.2.1这个插件工件，大概率是插件ID写法过时、仓库配置不全，或者2.2.1这个旧版本已从公共仓库下架导致的。

可行解决方案 #

1. 修正插件引用方式 #

Asciidoctor Gradle插件的ID在新版本里有变更，根据你的Gradle版本选对应写法：

• Gradle 4.0+ 推荐写法：用新的插件ID，同时升级到兼容的新版本（比如3.3.2，这个版本在Maven Central和Gradle插件门户都能找到）

// build.gradle
plugins {
    id 'org.asciidoctor.jvm.convert' version '3.3.2'
}

• 必须用2.2.1版本的写法：如果一定要保留旧版本，改用传统的buildscript依赖方式，确保仓库能找到旧版工件

// build.gradle
buildscript {
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath 'org.asciidoctor:asciidoctor-gradle-plugin:2.2.1'
    }
}

apply plugin: 'org.asciidoctor.convert'

2. 检查仓库配置是否完整 #

确认你的settings.gradle（或settings.gradle.kts）里同时配置了Gradle插件门户和Maven Central，避免仓库缺失导致找不到插件：

// settings.gradle
pluginManagement {
    repositories {
        gradlePluginPortal()
        mavenCentral()
    }
}

3. 优先升级插件版本（推荐） #

2.2.1是2020年的旧版本，可能已经从Gradle插件门户移除了，升级到最新稳定版本不仅能解决找不到的问题，还能修复旧版本的bug，获得更好的兼容性。

4. 清理本地Gradle缓存 #

如果上面的步骤都没用，删掉本地Gradle缓存再重新同步项目，避免缓存损坏导致的解析问题：

• Windows：删除C:\Users\<你的用户名>\.gradle\caches
• macOS/Linux：删除~/.gradle/caches

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