使用Ktor 3.1.1时Gradle提示io.ktor.plugin插件未找到问题求助

问题根源 #

你的build.gradle.kts配置逻辑错误：使用alias(libs.plugins.ktor)时，插件ID和版本需在gradle/libs.versions.toml中定义，而非直接在build脚本中声明ktor = {...}；同时Ktor官方插件的正确ID并非io.ktor.plugin，需根据项目类型选择对应插件ID。

正确配置步骤 #

1. 配置gradle/libs.versions.toml #

若项目根目录的gradle文件夹下无此文件，直接创建，添加以下内容：

[versions]
ktor = "3.1.1"

[plugins]
# JVM项目用这个插件ID
ktor-jvm = { id = "io.ktor.plugin.jvm", version.ref = "ktor" }
# 若是Android项目，替换成下面这行
# ktor-android = { id = "io.ktor.plugin.android", version.ref = "ktor" }

2. 修改build.gradle.kts #

替换原插件配置部分，移除错误声明：

plugins {
    // JVM项目用这行
    alias(libs.plugins.ktor.jvm)
    // Android项目替换成这行
    // alias(libs.plugins.ktor.android)
}

# 移除原有的 ktor = { id = "io.ktor.plugin", version.ref = "ktor-version" } 和 ktor-version = "3.1.1" 两行

3. 保留正确的settings.gradle.kts配置 #

你的pluginManagement仓库配置是正确的，无需修改：

pluginManagement {
    repositories {
        google {
            mavenContent {
                includeGroupAndSubgroups("androidx")
                includeGroupAndSubgroups("com.android")
                includeGroupAndSubgroups("com.google")
            }
        }
        mavenCentral()
        gradlePluginPortal()
    }
}

4. 清理并刷新依赖 #

执行命令强制刷新依赖缓存：

./gradlew clean build --refresh-dependencies

额外排查点 #

• 确认网络可正常访问Maven Central和Gradle Plugin Portal
• 若使用代理，检查gradle.properties中的代理配置是否正确

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