IntelliJ平台SDK与内嵌Kotlin编译器冲突引发类型不匹配问题的解决方案咨询

我正在开发一个IntelliJ平台插件，想集成ktfmt v0.54，但遇到了棘手的类型不匹配问题。甚至只引入org.jetbrains.kotlin:kotlin-compiler-embeddable也会触发同样的错误：

Argument type mismatch: actual type is ‘KotlinFileType!’, but ‘LanguageFileType’ was expected.
Argument type mismatch: actual type is ‘KotlinLanguage’, but ‘Language’ was expected.

明明KotlinFileType是LanguageFileType的子类，KotlinLanguage也是Language的子类，实在搞不懂为什么会出现这种类型不兼容的情况。想请教各位大佬，怎么解决这个依赖冲突？是不是要隔离ktfmt的使用？或者重新编译ktfmt？

复现代码示例 #

main.kt

//import com.facebook.ktfmt.format.Formatter
import com.intellij.lang.Language
//import com.intellij.openapi.editor.EditorFactory
//import com.intellij.openapi.editor.ex.EditorEx
//import com.intellij.openapi.fileTypes.FileTypeEditorHighlighterProviders
import com.intellij.openapi.fileTypes.LanguageFileType
import org.jetbrains.kotlin.idea.KotlinFileType
import org.jetbrains.kotlin.idea.KotlinLanguage

fun main() {
    println("Hello, ${myfunction(language = KotlinLanguage.INSTANCE, fileType = KotlinFileType.INSTANCE)}!");
}

fun myfunction(language: Language, fileType: LanguageFileType): String {
    // This is in my plugin, not the example. This is why I need fileType...
    // val editor = EditorFactory.getInstance().createEditor(EditorFactory.getInstance().createDocument(CODE)) as EditorEx;
    // FileTypeEditorHighlighterProviders.getInstance().forFileType(fileType)
    // .getEditorHighlighter(null,
    // fileType,
    // null,
    // editor.colorsScheme);
    // val formattingOptions = Formatter.KOTLINLANG_FORMAT;
    val formattedContent = CODE;//Formatter.format(formattingOptions, CODE)
    return "${language.id}: $formattedContent";
}

val CODE: String = """
open class Some {
}
""".trimIndent()

build.gradle.kts

plugins {
    id("java")
    kotlin("jvm") version "2.1.21"
    id("org.jetbrains.intellij.platform") version "2.6.0"
}

group = "net.ddns.rkdawenterprises"
version = "1.0-SNAPSHOT"

repositories {
    mavenCentral()
    intellijPlatform {
        defaultRepositories()
    }
}

dependencies {
    // implementation("com.facebook:ktfmt:0.54")
    implementation("org.jetbrains.kotlin:kotlin-compiler:2.1.21")
    intellijPlatform {
        create(providers.gradleProperty("platformType"), providers.gradleProperty("platformVersion"))
    }
}

kotlin {
    jvmToolchain(21)
}

tasks.withType<Jar> {
    manifest {
        attributes["Main-Class"] = "net.ddns.rkdawenterprises.example.MainKt";
    }
}

问题分析 #

这种类型不匹配的本质是类加载器冲突：IntelliJ平台SDK本身已经包含了一套Kotlin相关的核心类（比如Language、LanguageFileType），而ktfmt依赖的kotlin-compiler-embeddable也自带了一套完全同名的类。虽然这些类的全限定名一模一样，但由于它们被不同的类加载器加载，JVM会将它们视为完全不同的类型，导致子类实例无法向上转型到平台SDK的父类类型。

解决方案建议 #

1. 排除ktfmt中的冲突依赖，复用平台SDK的Kotlin类

这是最直接的方案，在build.gradle.kts中调整ktfmt的依赖，排除掉它自带的Kotlin相关模块，让插件直接使用平台SDK提供的版本：

implementation("com.facebook:ktfmt:0.54") {
    exclude(group = "org.jetbrains.kotlin", module = "kotlin-compiler-embeddable")
    exclude(group = "org.jetbrains.kotlin", module = "kotlin-stdlib")
    exclude(group = "org.jetbrains.kotlin", module = "kotlin-stdlib-jdk8")
    // 可以根据实际依赖树添加更多需要排除的模块
}

⚠️ 注意：要确保ktfmt的版本和你使用的IntelliJ平台SDK自带的Kotlin版本兼容，如果版本差异太大，可能会引发其他兼容性问题，必要时可以调整ktfmt的版本来匹配平台。

2. 使用类加载器隔离ktfmt的执行

如果排除依赖的方式行不通，可以尝试把ktfmt的运行逻辑放在独立的类加载器中，避免和平台SDK的类加载器产生混淆。比如通过URLClassLoader来加载ktfmt的jar包：

// 示例思路，需要根据实际场景完善
val ktfmtJar = File("libs/ktfmt-0.54.jar") // 替换为你的ktfmt jar路径
val isolatedClassLoader = URLClassLoader(arrayOf(ktfmtJar.toURI().toURL()), null) // 父类加载器设为null，完全隔离平台类
val formatterClass = isolatedClassLoader.loadClass("com.facebook.ktfmt.format.Formatter")
// 通过反射调用ktfmt的格式化方法
val formatMethod = formatterClass.getMethod("format", formatterClass.getDeclaredClass("FormattingOptions"), String::class.java)
val formattingOptions = formatterClass.getField("KOTLINLANG_FORMAT").get(null)
val formattedCode = formatMethod.invoke(null, formattingOptions, CODE)

这种方式的缺点是需要用反射调用ktfmt的API，代码会相对繁琐，但能彻底解决类加载冲突的问题。

3. 重新编译ktfmt，适配平台SDK的Kotlin版本

如果上述方案都不适用，可以考虑fork ktfmt的官方仓库，修改其构建配置，将依赖的Kotlin编译器版本改为和你使用的IntelliJ平台SDK一致的版本，然后重新编译ktfmt，再将自定义编译的版本引入到你的插件项目中。

调试小技巧 #

• 执行./gradlew dependencies查看项目的依赖树，确认哪些模块引入了冲突的Kotlin类
• 打印类的类加载器信息，验证是否存在类加载器冲突：

  println("Platform Language类加载器: ${Language::class.java.classLoader}")
  println("KotlinLanguage类加载器: ${KotlinLanguage::class.java.classLoader}")
  

  如果两个类加载器实例不同，就可以确认是类加载器导致的类型不匹配问题。

内容来源于stack exchange