Gradle项目生成Allure Report遇插件未找到错误，请求分析根因

问题描述 #

在基于Gradle的项目中集成Allure Report时，出现插件未找到的错误，尝试更换不同版本的Allure报告及插件后仍未解决。

项目配置片段（build.gradle） #

plugins {
    id 'io.qameta.allure' version '2.8.1'
}

def allureVersion = '2.14.0'

repositories {
    mavenCentral()
}

allure {
    version = allureVersion
    autoconfigure = false
    aspectjweaver = true
}
 
dependencies {
    // Junit5
    testImplementation 'org.junit.jupiter:junit-jupiter:5.7.2'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.7.2'
    // Allure
    implementation 'io.qameta.allure:allure-junit5:2.14.0'
    runtimeOnly 'org.aspectj:aspectjweaver:1.9.7'
}

环境信息 #

• Gradle版本：7.3.3
• Java SDK：Amazon Corretto 17

错误信息 #

org.gradle.api.plugins.UnknownPluginException: Plugin [id: 'io.qameta.allure', version: '2.8.1'] was not found in any of the following sources:

- Gradle Core Plugins (plugin is not in 'org.gradle' namespace)
- Plugin Repositories (could not resolve plugin artifact 'io.qameta.allure:io.qameta.allure.gradle.plugin:2.8.1')
  Searched in the following repositories:
    Gradle Central Plugin Repository
    Google
    MavenRepo

根本原因分析 #

1. 插件版本不存在：指定的Allure插件版本2.8.1在Gradle插件仓库中没有对应的io.qameta.allure.gradle.plugin构件，导致无法解析。
2. 版本不匹配：插件版本2.8.1与使用的Allure核心版本2.14.0差距过大，低版本插件可能未在Gradle插件门户上架，同时版本差异也会引发兼容性问题。
3. 插件引入方式差异：早期Allure Gradle插件需通过buildscript块引入，直接用plugins块引用旧版本ID会导致解析失败。

解决方案 #

方案1：使用与核心版本匹配的插件版本 #

将插件版本修改为与Allure核心版本一致的2.14.0，确保仓库中存在该版本构件：

plugins {
    id 'io.qameta.allure' version '2.14.0'
}

方案2：用buildscript方式引入插件（兼容旧版本） #

若需使用特定旧版本插件，可通过buildscript块手动引入：

buildscript {
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath 'io.qameta.allure:allure-gradle:2.14.0' // 替换为目标版本
    }
}

apply plugin: 'io.qameta.allure'

额外注意事项 #

• 插件版本尽量与Allure核心版本保持一致，避免兼容性冲突。
• 确认网络连接正常，确保Gradle能访问Maven Central或Gradle插件仓库。

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