Kotlin Notebook无法解析mavenLocal依赖，IntelliJ中却正常，原因何在？

问题背景 #

我有一个本地Kotlin依赖com.rough4:rough4:0.0，全局暴露了函数myPrintln(msg:String)，已发布到mavenLocal仓库（路径/home/user/.m2/repository）。

依赖的构建配置：

//rough4/build.gradle.kts
plugins {
    kotlin("jvm") version "2.0.0"
    `maven-publish`
}
group = "com.rough4"
version = "0.0"

repositories {
    mavenCentral()
    mavenLocal()
}

kotlin {
    jvmToolchain(21)
}

java{
    withSourcesJar()
    withJavadocJar()
}

publishing{
    publications {
        create<MavenPublication>("Testing"){
            from(components["java"])
        }
    }
}

函数实现：

//rough4/src/main/kotlin/localFuncs.kt
fun myPrintln(msg:String){
    println(msg)
}

在标准IntelliJ项目中，通过dependencies { implementation("com.rough4:rough4:0.0") }引入后能正常解析并使用myPrintln，说明依赖发布流程没问题。但在Kotlin Notebook中，无论是注解语法还是Gradle风格的USE语法都无法解析该依赖，只有把依赖加到项目的build.gradle.kts中，Notebook才能自动访问myPrintln。

原因分析 #

1. mavenLocal仓库解析机制差异
   IntelliJ项目的Gradle会自动读取系统默认的mavenLocal配置（包括~/.m2/settings.xml），但Kotlin Jupyter内核对*mavenLocal的解析兼容性不足，尤其是当本地仓库的maven元数据不完整时，内核无法通过坐标定位依赖。

2. 依赖元数据完整性要求更高
   虽然依赖已发布到mavenLocal，但如果缺失完整的pom.xml或元数据文件（比如maven-metadata.xml），Kotlin Jupyter内核无法识别依赖坐标。而IntelliJ的Gradle集成对元数据的容错性更强，甚至能直接通过jar包路径识别。

3. 类加载器隔离
   Kotlin Notebook的类加载器和IntelliJ项目的类加载器是隔离的。把依赖加到项目build.gradle时，Notebook会共享项目的类路径，因此能访问到依赖；但直接在Notebook中声明依赖时，内核需要独立解析加载，一旦仓库配置或元数据有问题就会失败。

解决方案 #

方案1：确保本地依赖元数据完整 #

重新执行./gradlew publishToMavenLocal，确保Gradle生成完整的发布文件（包括rough4-0.0.pom、maven-metadata-local.xml等）都存在于~/.m2/repository/com/rough4/rough4/0.0/目录下，且pom.xml中正确包含groupId、artifactId、version字段。

方案2：直接引用本地jar包路径 #

跳过maven仓库解析，直接指定jar包的绝对路径：

@file:DependsOn("/home/user/.m2/repository/com/rough4/rough4/0.0/rough4-0.0.jar")
import myPrintln

myPrintln("测试成功")

方案3：配置Kotlin Jupyter全局仓库 #

修改Kotlin Jupyter的配置文件，添加本地仓库路径：

1. 找到配置目录（通常为~/.jupyter/kotlin/）
2. 编辑repositories.json，添加本地仓库：

   {
     "repositories": [
       "https://repo1.maven.org/maven2/",
       "file:///home/user/.m2/repository/"
     ]
   }
   

3. 重启IntelliJ和Notebook后再尝试用注解语法引入依赖。

方案4：复用项目级依赖（已验证有效） #

继续使用你发现的可行方式：将依赖添加到Notebook所在IntelliJ项目的build.gradle.kts中，让Notebook共享项目的类路径，适合需要复用项目依赖的场景。

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