Kotlin Language Server无法识别Gradle依赖问题求助

在AstroNeoVim中配置kotlin_language_server和Treesitter后，出现LSP无法识别项目依赖类的问题：终端执行gradle build/run可正常构建运行，但NeoVim中持续报类未找到错误。已尝试更换其他Kotlin LSP、确认JAVA_HOME配置正常、Gradle命令行运行无异常。

解决方案 #

1. 触发LSP重新读取Gradle构建元数据 #

kotlin_language_server依赖Gradle生成的构建缓存与模块元数据，尝试以下操作：

• 打开项目根目录的build.gradle/build.gradle.kts文件，等待LSP自动重新初始化
• 在NeoVim中执行:LspRestart kotlin_language_server手动重启LSP
• 执行gradle clean build --no-build-cache重新生成完整的构建元数据，再重启NeoVim

2. 配置LSP正确识别项目根目录 #

AstroNeoVim默认的LSP根目录检测可能不准确，手动指定根目录规则：
在AstroNeoVim的LSP配置文件（如lua/user/lsp/configs/kotlin_language_server.lua）中添加：

require("lspconfig").kotlin_language_server.setup({
  root_dir = require("lspconfig.util").root_pattern(
    "build.gradle",
    "build.gradle.kts",
    "settings.gradle",
    "settings.gradle.kts",
    ".git"
  ),
})

保存配置后重启NeoVim，让LSP重新定位项目根目录。

3. 校验版本兼容性 #

确保kotlin_language_server版本与项目中Gradle Kotlin插件版本匹配：

• 查看项目中Kotlin插件版本：在build.gradle.kts中找到kotlin("jvm") version "x.y.z"
• 确认kotlin_language_server支持该插件版本，若不匹配则升级或降级对应组件

4. 检查依赖缓存访问权限 #

kotlin_language_server需要读取Gradle下载的依赖jar包，确保NeoVim进程有权限访问以下路径：

• 本地Gradle缓存目录：~/.gradle/caches/modules-2/files-2.1
• 项目构建缓存目录：build/dependency-cache

5. 通过Gradle任务生成LSP配置 #

部分版本的kotlin_language_server支持Gradle任务生成适配配置，在项目根目录执行：

./gradlew kotlinLanguageServerConfigure

执行完成后重启NeoVim，让LSP加载生成的配置文件。

内容的提问来源于stack exchange，提问作者Vojin Purić