入门Ktor遇Gradle问题求助：排查方向与解决方案

是否需要改用IntelliJ IDEA Ultimate？ #

不需要，IntelliJ IDEA社区版完全支持Ktor和Gradle项目，你的问题与IDE版本无关。

错误1：Task 'wrapper' not found in project ':tutorial-server-get-started'. #

该问题源于项目缺少Gradle Wrapper相关文件，解决步骤：

• 打开项目根目录终端，执行命令生成Wrapper：

  # macOS/Linux
  ./gradlew wrapper --gradle-version 7.6
  
  # Windows
  gradlew.bat wrapper --gradle-version 7.6
  

• 若为多模块项目，检查settings.gradle.kts确保子项目被正确包含：

  include(":tutorial-server-get-started")
  

• 单模块项目需确保settings.gradle.kts配置根项目名称：

  rootProject.name = "tutorial-server-get-started"
  

错误2：Plugin [id: 'org.jetbrains.kotlin.jvm', version: '2.2.3'] was not found in any of the following sources: #

核心问题是Kotlin版本与Ktor版本不兼容，且插件版本不一致：

1. Ktor 1.8.10仅支持Kotlin 1.8.x系列，无法兼容Kotlin 2.x版本
2. Kotlin序列化插件版本必须与Kotlin JVM插件版本完全匹配

修正后的配置文件

gradle.properties

ktor_version=1.8.10
kotlin_version=1.8.10
logback_version=1.2.11
kotlin.code.style=official

gradle.kts

val ktor_version: String by project
val kotlin_version: String by project
val logback_version: String by project

plugins {
    kotlin("jvm") version kotlin_version
    application
    kotlin("plugin.serialization") version kotlin_version
}

group = "com.example"
version = "0.0.1"
application {
    mainClass.set("com.example.ApplicationKt")

    val isDevelopment: Boolean = project.ext.has("development")
    applicationDefaultJvmArgs = listOf("-Dio.ktor.development=$isDevelopment")
}

repositories {
    mavenCentral()
}

dependencies {
    implementation("io.ktor:ktor-network-tls-jvm:$ktor_version")
    implementation("io.ktor:ktor-server-core:$ktor_version")
    implementation("io.ktor:ktor-websockets:$ktor_version")
    implementation("io.ktor:ktor-serialization:$ktor_version")
    implementation("io.ktor:ktor-auth:$ktor_version")
    implementation("io.ktor:ktor-auth-jwt:$ktor_version")
    implementation("io.ktor:ktor-server-netty:$ktor_version")
    implementation("ch.qos.logback:logback-classic:$logback_version")
    testImplementation("io.ktor:ktor-server-tests:$ktor_version")
    testImplementation("org.jetbrains.kotlin:kotlin-test-junit:$kotlin_version")
}

额外排查步骤 #

• 执行./gradlew clean build --refresh-dependencies清理缓存并重新构建
• 检查IDEA的Gradle设置，确保使用项目本地的Gradle Wrapper（而非IDEA内置版本）

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