Go to Definition' (gd) isn't working for Java's Standard Library using jdtls

[sjoerdschouten]

Summary

When using 'go to definition' (gd) on standard Java library types, like java.util.List, it simply doesn't work. While JDTLS (the language server) should. support this feature and hover (space k) works fine, logs from both JDTLS and Helix indicate Helix isn't sending the required textDocument/definition request.

Reproduction Steps

Start a Standard Maven Project

Open your terminal and create a basic Maven project with the following commands:

mvn -B archetype:generate -DgroupId=com.example -DartifactId=my-app -Dversion=1.0.0 -DinteractiveMode=false
cd my-app

Create or Update src/main/java/com/example/Main.java

First, remove App.java if it's present. Then, create or update src/main/java/com/example/Main.java with the following code:

package com.example;

import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<String> myStrings; // Place cursor on 'List' to test 'gd'. Result: "No definition found"

        // 'gd' works fine on below method.
        gdMe();
    }

    public static void gdMe() {
} // jumps to here
        

Adjust pom.xml

Ensure your pom.xml file is targeting your JDK version (21 in my case) by replacing its content with the following:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>my-app</artifactId>
    <version>1.0-SNAPSHOT</version>
    <properties>
        <maven.compiler.source>21</maven.compiler.source>
        <maven.compiler.target>21</maven.compiler.target>
    </properties>
</project>

Set up languages.toml

Create a languages.toml file in your my-app directory to configure JDTLS and enable detailed logging for both JDTLS and Helix:

[[language]]
name = "java"
scope = "source.java"
file-types = ["java"]
roots = ["pom.xml"]
language-servers = ["jdtls"]

[language-server.jdtls]
command = "jdtls"
args = ["-data", "/tmp/jdtls-workspace-my-app", "-Dlog.level=ALL", ">>", "jdtls.log", "2>&1"]

Launch Helix and Test

From the my-app directory, launch Helix with trace-level logging:

hx --log trace .

• Open src/main/java/com/example/Main.java.
• Place your cursor on the List symbol (line 6).
• Execute the 'go to definition' command (gd).
• Close Helix.

---

What Should Happen (Expected Behavior)

Helix should send a textDocument/definition request to JDTLS and navigate to the java.util.List source (usually located in src.zip).

What Actually Happens (Actual Behavior)

Nothing occurs. Helix displays "No definition found" in the status bar.

Helix log

helix log

2025-08-04T20:04:10.259 helix_lsp::transport [INFO] jdtls -> {"jsonrpc":"2.0","method":"initialize","params":{"capabilities":{"general":{"positionEncodings":["utf-8","utf-32","utf-16"]},"textDocument":{"codeAction":{"codeActionLiteralSupport":{"codeActionKind":{"valueSet":["","quickfix","refactor","refactor.extract","refactor.inline","refactor.rewrite","source","source.organizeImports"]}},"dataSupport":true,"disabledSupport":true,"isPreferredSupport":true,"resolveSupport":{"properties":["edit","command"]}},"completion":{"completionItem":{"deprecatedSupport":true,"insertReplaceSupport":true,"resolveSupport":{"properties":["documentation","detail","additionalTextEdits"]},"snippetSupport":true,"tagSupport":{"valueSet":[1]}},"completionItemKind":{}},"formatting":{"dynamicRegistration":false},"hover":{"contentFormat":["markdown"]},"inlayHint":{"dynamicRegistration":false},"publishDiagnostics":{"tagSupport":{"valueSet":[1,2]},"versionSupport":true},"rename":{"dynamicRegistration":false,"honorsChangeAnnotations":false,"prepareSupport":true},"signatureHelp":{"signatureInformation":{"activeParameterSupport":true,"documentationFormat":["markdown"],"parameterInformation":{"labelOffsetSupport":true}}}},"window":{"workDoneProgress":true},"workspace":{"applyEdit":true,"configuration":true,"didChangeConfiguration":{"dynamicRegistration":false},"didChangeWatchedFiles":{"dynamicRegistration":true,"relativePatternSupport":false},"executeCommand":{"dynamicRegistration":false},"fileOperations":{"didRename":true,"willRename":true},"inlayHint":{"refreshSupport":false},"symbol":{"dynamicRegistration":false},"workspaceEdit":{"documentChanges":true,"failureHandling":"abort","normalizesLineEndings":false,"resourceOperations":["create","rename","delete"]},"workspaceFolders":true}},"clientInfo":{"name":"helix","version":"25.07.1 (a05c151b)"},"processId":46426,"rootPath":"/Users/sjoerd/Projects/Java/helix-java-bug-report-setup/my-app","rootUri":"file:///Users/sjoerd/Projects/Java/helix-java-bug-report-setup/my-app","workspaceFolders":[{"name":"my-app","uri":"file:///Users/sjoerd/Projects/Java/helix-java-bug-report-setup/my-app"}]},"id":0}
2025-08-04T20:04:12.493 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","id":"1","method":"window/workDoneProgress/create","params":{"token":"6484c354-073e-4671-a4c3-7185ee10ea7a"}}
2025-08-04T20:04:12.494 helix_lsp::transport [INFO] Language server not initialized, delaying request
2025-08-04T20:04:12.495 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"6484c354-073e-4671-a4c3-7185ee10ea7a","value":{"kind":"begin","title":"Building","message":"Building"}}}
2025-08-04T20:04:12.496 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"6484c354-073e-4671-a4c3-7185ee10ea7a","value":{"kind":"report","message":"Building - 0% ","percentage":0}}}
2025-08-04T20:04:12.496 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"6484c354-073e-4671-a4c3-7185ee10ea7a","value":{"kind":"end","message":"Building"}}}
2025-08-04T20:04:12.498 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"language/status","params":{"type":"Starting","message":"Init..."}}
2025-08-04T20:04:12.499 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"language/status","params":{"type":"Starting","message":"0% Starting Java Language Server"}}
2025-08-04T20:04:12.499 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","id":"2","method":"window/workDoneProgress/create","params":{"token":"15cc8b15-5935-4448-9ead-554c7299deeb"}}
2025-08-04T20:04:12.499 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"15cc8b15-5935-4448-9ead-554c7299deeb","value":{"kind":"begin","title":"Initialize Workspace","message":"Initialize Workspace"}}}
2025-08-04T20:04:12.498 helix_term::application [INFO] Ignoring Unhandled notification from Language Server
2025-08-04T20:04:12.499 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"15cc8b15-5935-4448-9ead-554c7299deeb","value":{"kind":"report","message":"Initialize Workspace - 0% ","percentage":0}}}
2025-08-04T20:04:12.499 helix_term::application [INFO] Ignoring Unhandled notification from Language Server
2025-08-04T20:04:12.499 helix_lsp::transport [INFO] Language server not initialized, delaying request
2025-08-04T20:04:12.502 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","id":0,"result":{"capabilities":{"textDocumentSync":{"openClose":true,"change":2,"save":{"includeText":true}},"hoverProvider":true,"completionProvider":{"resolveProvider":true,"triggerCharacters":[".","@","#","*"," "]},"signatureHelpProvider":{"triggerCharacters":["(",","]},"definitionProvider":true,"typeDefinitionProvider":true,"implementationProvider":true,"referencesProvider":true,"documentHighlightProvider":true,"documentSymbolProvider":true,"workspaceSymbolProvider":true,"codeActionProvider":{"codeActionKinds":["quickfix","refactor","refactor.extract","refactor.inline","refactor.rewrite","source","source.organizeImports"],"resolveProvider":true},"codeLensProvider":{"resolveProvider":true},"documentFormattingProvider":true,"documentRangeFormattingProvider":true,"documentOnTypeFormattingProvider":{"firstTriggerCharacter":";","moreTriggerCharacter":["\n","}"]},"renameProvider":{"prepareProvider":true},"foldingRangeProvider":true,"declarationProvider":true,"executeCommandProvider":{"commands":["java.project.import","java.project.changeImportedProjects","java.navigate.openTypeHierarchy","java.project.resolveStackTraceLocation","java.edit.handlePasteEvent","java.edit.stringFormatting","java.project.getSettings","java.project.resolveWorkspaceSymbol","java.project.upgradeGradle","java.project.createModuleInfo","java.vm.getAllInstalls","java.edit.organizeImports","java.project.refreshDiagnostics","java.project.removeFromSourcePath","java.project.listSourcePaths","java.project.updateSettings","java.project.getAll","java.reloadBundles","java.project.isTestFile","java.project.resolveText","java.project.getClasspaths","java.navigate.resolveTypeHierarchy","java.edit.smartSemicolonDetection","java.project.updateSourceAttachment","java.project.updateClassPaths","java.decompile","java.protobuf.generateSources","java.project.resolveSourceAttachment","java.project.updateJdk","java.project.addToSourcePath","java.completion.onDidSelect"]},"workspace":{"workspaceFolders":{"supported":true,"changeNotifications":true},"fileOperations":{"willRename":{"filters":[{"pattern":{"glob":"**/*.java","matches":"file"},"scheme":"file"},{"pattern":{"glob":"**","matches":"folder"},"scheme":"file"}]}}},"typeHierarchyProvider":true,"callHierarchyProvider":true,"selectionRangeProvider":true,"semanticTokensProvider":{"legend":{"tokenTypes":["namespace","class","interface","enum","enumMember","type","typeParameter","method","property","variable","parameter","modifier","keyword","annotation","annotationMember","record","recordComponent"],"tokenModifiers":["abstract","static","readonly","deprecated","declaration","documentation","public","private","protected","native","generic","typeArgument","importDeclaration","constructor"]},"range":false,"full":{"delta":false},"documentSelector":[{"language":"java","scheme":"file"},{"language":"java","scheme":"jdt"}]},"inlayHintProvider":true}}}
2025-08-04T20:04:12.503 helix_lsp::transport [INFO] Draining pending message Response(Success(Success { jsonrpc: Some(V2), result: Null, id: Str("1") }))
2025-08-04T20:04:12.503 helix_lsp::transport [INFO] jdtls -> {"jsonrpc":"2.0","result":null,"id":"1"}
2025-08-04T20:04:12.503 helix_lsp::transport [INFO] Draining pending message Response(Success(Success { jsonrpc: Some(V2), result: Null, id: Str("2") }))
2025-08-04T20:04:12.503 helix_lsp::transport [INFO] jdtls -> {"jsonrpc":"2.0","result":null,"id":"2"}
2025-08-04T20:04:12.503 helix_lsp::transport [INFO] jdtls -> {"jsonrpc":"2.0","method":"initialized","params":{}}
2025-08-04T20:04:12.503 helix_lsp::transport [INFO] jdtls -> {"jsonrpc":"2.0","method":"textDocument/didOpen","params":{"textDocument":{"languageId":"java","text":"package com.example;\n\nimport java.util.List;\n\npublic class Main {\n    public static void main(String[] args) {\n        // this works\n        gdMe();\n        // gd on List does not work, but space + k does\n        List<String> myStrings;\n    }\n\n    public static void gdMe() {\n    \n    }\n}\n","uri":"file:///Users/sjoerd/Projects/Java/helix-java-bug-report-setup/my-app/src/main/java/com/example/Main.java","version":0}}}
2025-08-04T20:04:13.083 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","id":"3","method":"window/workDoneProgress/create","params":{"token":"4682257e-18e5-4e11-aea6-8c8e80a9a84d"}}
2025-08-04T20:04:13.083 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"4682257e-18e5-4e11-aea6-8c8e80a9a84d","value":{"kind":"begin","title":"Repository registry initialization","message":"Repository registry initialization"}}}
2025-08-04T20:04:13.083 helix_lsp::transport [INFO] jdtls -> {"jsonrpc":"2.0","result":null,"id":"3"}
2025-08-04T20:04:13.083 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"4682257e-18e5-4e11-aea6-8c8e80a9a84d","value":{"kind":"end","message":"Repository registry initialization"}}}
2025-08-04T20:04:13.091 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"language/status","params":{"type":"Starting","message":"10% Starting Java Language Server"}}
2025-08-04T20:04:13.091 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"15cc8b15-5935-4448-9ead-554c7299deeb","value":{"kind":"report","message":"Initialize Workspace - 10% ","percentage":10}}}
2025-08-04T20:04:13.091 helix_term::application [INFO] Ignoring Unhandled notification from Language Server
2025-08-04T20:04:13.116 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"language/status","params":{"type":"ProjectStatus","message":"OK"}}
2025-08-04T20:04:13.116 helix_term::application [INFO] Ignoring Unhandled notification from Language Server
2025-08-04T20:04:13.116 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"language/status","params":{"type":"Starting","message":"100% Starting Java Language Server - Opening \u0027my-app\u0027."}}
2025-08-04T20:04:13.116 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"15cc8b15-5935-4448-9ead-554c7299deeb","value":{"kind":"end","message":"Importing Maven project(s)"}}}
2025-08-04T20:04:13.116 helix_term::application [INFO] Ignoring Unhandled notification from Language Server
2025-08-04T20:04:13.117 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"language/status","params":{"type":"Started","message":"Ready"}}
2025-08-04T20:04:13.118 helix_term::application [INFO] Ignoring Unhandled notification from Language Server
2025-08-04T20:04:13.118 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"language/status","params":{"type":"Starting","message":"100% Starting Java Language Server - Opening \u0027my-app\u0027."}}
2025-08-04T20:04:13.118 helix_term::application [INFO] Ignoring Unhandled notification from Language Server
2025-08-04T20:04:13.126 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","id":"4","method":"client/registerCapability","params":{"registrations":[{"id":"d5da1e18-cc28-41f3-86b3-d80769dd4fa1","method":"workspace/didChangeWorkspaceFolders"}]}}
2025-08-04T20:04:13.126 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"language/status","params":{"type":"ServiceReady","message":"ServiceReady"}}
2025-08-04T20:04:13.126 helix_term::application [WARN] Ignoring a client/registerCapability request because dynamic capability registration is not enabled. Please report this upstream to the language server
2025-08-04T20:04:13.126 helix_lsp::transport [INFO] jdtls -> {"jsonrpc":"2.0","result":null,"id":"4"}
2025-08-04T20:04:13.127 helix_term::application [INFO] Ignoring Unhandled notification from Language Server
2025-08-04T20:04:13.132 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","id":"5","method":"window/workDoneProgress/create","params":{"token":"20de4b9d-9686-43d4-840f-51879a5938b2"}}
2025-08-04T20:04:13.132 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"20de4b9d-9686-43d4-840f-51879a5938b2","value":{"kind":"begin","title":"Building","message":"Building"}}}
2025-08-04T20:04:13.132 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"20de4b9d-9686-43d4-840f-51879a5938b2","value":{"kind":"report","message":"Building - 0% ","percentage":0}}}
2025-08-04T20:04:13.132 helix_lsp::transport [INFO] jdtls -> {"jsonrpc":"2.0","result":null,"id":"5"}
2025-08-04T20:04:13.133 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"20de4b9d-9686-43d4-840f-51879a5938b2","value":{"kind":"end","message":"Building"}}}
2025-08-04T20:04:13.149 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","id":"6","method":"client/registerCapability","params":{"registrations":[{"id":"b3e6d8b2-d553-452e-8e79-7293a559e817","method":"workspace/didChangeWatchedFiles","registerOptions":{"watchers":[{"globPattern":"**/*.java"},{"globPattern":"**/.project"},{"globPattern":"**/.classpath"},{"globPattern":"**/.settings/*.prefs"},{"globPattern":"**/src/**"},{"globPattern":"**/*.gradle"},{"globPattern":"**/*.gradle.kts"},{"globPattern":"**/gradle.properties"},{"globPattern":"**/pom.xml"},{"globPattern":{"baseUri":"file:/Users/sjoerd/Projects/Java/helix-java-bug-report-setup/","pattern":"my-app"},"kind":4}]}}]}}
2025-08-04T20:04:13.150 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","id":"7","method":"window/workDoneProgress/create","params":{"token":"bd23f4c0-1842-4097-ba14-2db22eb32dc1"}}
2025-08-04T20:04:13.150 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"bd23f4c0-1842-4097-ba14-2db22eb32dc1","value":{"kind":"begin","title":"Searching...","message":"Searching..."}}}
2025-08-04T20:04:13.150 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"bd23f4c0-1842-4097-ba14-2db22eb32dc1","value":{"kind":"report","message":"Searching... - 0% ","percentage":0}}}
2025-08-04T20:04:13.151 helix_lsp::transport [INFO] jdtls -> {"jsonrpc":"2.0","result":null,"id":"6"}
2025-08-04T20:04:13.151 helix_lsp::transport [INFO] jdtls -> {"jsonrpc":"2.0","result":null,"id":"7"}
2025-08-04T20:04:13.516 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"textDocument/publishDiagnostics","params":{"uri":"file:///Users/sjoerd/Projects/Java/helix-java-bug-report-setup/my-app/src/test/java/com/example/AppTest.java","diagnostics":[{"range":{"start":{"line":4,"character":7},"end":{"line":4,"character":12}},"severity":1,"code":"268435846","source":"Java","message":"The import junit cannot be resolved"},{"range":{"start":{"line":10,"character":12},"end":{"line":10,"character":20}},"severity":1,"code":"16777218","source":"Java","message":"TestCase cannot be resolved to a type"},{"range":{"start":{"line":25,"character":18},"end":{"line":25,"character":22}},"severity":1,"code":"16777218","source":"Java","message":"Test cannot be resolved to a type"},{"range":{"start":{"line":27,"character":19},"end":{"line":27,"character":28}},"severity":1,"code":"16777218","source":"Java","message":"TestSuite cannot be resolved to a type"},{"range":{"start":{"line":35,"character":8},"end":{"line":35,"character":18}},"severity":1,"code":"67108964","source":"Java","message":"The method assertTrue(boolean) is undefined for the type AppTest"},{"range":{"start":{"line":2,"character":7},"end":{"line":2,"character":12}},"severity":1,"code":"268435846","source":"Java","message":"The import junit cannot be resolved"},{"range":{"start":{"line":3,"character":7},"end":{"line":3,"character":12}},"severity":1,"code":"268435846","source":"Java","message":"The import junit cannot be resolved"}]}}
2025-08-04T20:04:13.929 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","id":"8","method":"window/workDoneProgress/create","params":{"token":"5687174f-03ad-4080-9997-df1871f42050"}}
2025-08-04T20:04:13.929 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"5687174f-03ad-4080-9997-df1871f42050","value":{"kind":"begin","title":"Validate documents","message":"Validate documents"}}}
2025-08-04T20:04:13.929 helix_lsp::transport [INFO] jdtls -> {"jsonrpc":"2.0","result":null,"id":"8"}
2025-08-04T20:04:13.929 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"5687174f-03ad-4080-9997-df1871f42050","value":{"kind":"report","message":"Validate documents - 0% ","percentage":0}}}
2025-08-04T20:04:13.931 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"5687174f-03ad-4080-9997-df1871f42050","value":{"kind":"end","message":"Validate documents"}}}
2025-08-04T20:04:14.536 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","id":"9","method":"window/workDoneProgress/create","params":{"token":"900cfe3f-153e-4b43-a0a1-070081d46746"}}
2025-08-04T20:04:14.536 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"900cfe3f-153e-4b43-a0a1-070081d46746","value":{"kind":"begin","title":"Publish Diagnostics","message":"Publish Diagnostics"}}}
2025-08-04T20:04:14.536 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"900cfe3f-153e-4b43-a0a1-070081d46746","value":{"kind":"report","message":"Publish Diagnostics - 0% ","percentage":0}}}
2025-08-04T20:04:14.536 helix_lsp::transport [INFO] jdtls -> {"jsonrpc":"2.0","result":null,"id":"9"}
2025-08-04T20:04:14.680 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"textDocument/publishDiagnostics","params":{"uri":"file:///Users/sjoerd/Projects/Java/helix-java-bug-report-setup/my-app/src/main/java/com/example/Main.java","diagnostics":[{"range":{"start":{"line":9,"character":21},"end":{"line":9,"character":30}},"severity":2,"code":"536870973","source":"Java","message":"The value of the local variable myStrings is not used","tags":[1]}]}}
2025-08-04T20:04:14.681 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"900cfe3f-153e-4b43-a0a1-070081d46746","value":{"kind":"end","message":"Publish Diagnostics"}}}
2025-08-04T20:04:17.030 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"bd23f4c0-1842-4097-ba14-2db22eb32dc1","value":{"kind":"report","message":"Searching... - 80% 1 files to index ()","percentage":79}}}
2025-08-04T20:04:17.147 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","method":"$/progress","params":{"token":"bd23f4c0-1842-4097-ba14-2db22eb32dc1","value":{"kind":"end","message":"Searching..."}}}
2025-08-04T20:04:19.530 helix_lsp::transport [INFO] jdtls -> {"jsonrpc":"2.0","method":"textDocument/inlayHint","params":{"range":{"end":{"character":0,"line":16},"start":{"character":0,"line":0}},"textDocument":{"uri":"file:///Users/sjoerd/Projects/Java/helix-java-bug-report-setup/my-app/src/main/java/com/example/Main.java"}},"id":1}
2025-08-04T20:04:19.656 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","id":1,"result":[]}
2025-08-04T20:04:45.514 helix_lsp::transport [INFO] jdtls -> {"jsonrpc":"2.0","method":"textDocument/definition","params":{"position":{"character":11,"line":9},"textDocument":{"uri":"file:///Users/sjoerd/Projects/Java/helix-java-bug-report-setup/my-app/src/main/java/com/example/Main.java"}},"id":2}
2025-08-04T20:04:45.620 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","id":2,"result":[]}
2025-08-04T20:04:49.059 helix_lsp::transport [INFO] jdtls -> {"jsonrpc":"2.0","method":"shutdown","id":3}
2025-08-04T20:04:49.064 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","id":3,"result":{}}
2025-08-04T20:04:49.064 helix_lsp::client [WARN] language server failed to terminate gracefully - failed to parse: invalid type: map, expected unit
2025-08-04T20:04:49.064 helix_lsp::transport [INFO] jdtls -> {"jsonrpc":"2.0","method":"exit"}

jdtls logs

WARNING: Using incubator modules: jdk.incubator.vector
Aug 04, 2025 8:04:11 PM org.apache.aries.spifly.BaseActivator log
INFO: Registered provider ch.qos.logback.classic.spi.LogbackServiceProvider of service org.slf4j.spi.SLF4JServiceProvider in bundle ch.qos.logback.classic
Content-Length: 126

{"jsonrpc":"2.0","id":"1","method":"window/workDoneProgress/create","params":{"token":"6484c354-073e-4671-a4c3-7185ee10ea7a"}}Content-Length: 162

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"6484c354-073e-4671-a4c3-7185ee10ea7a","value":{"kind":"begin","title":"Building","message":"Building"}}}Content-Length: 165

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"6484c354-073e-4671-a4c3-7185ee10ea7a","value":{"kind":"report","message":"Building - 0% ","percentage":0}}}Content-Length: 141

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"6484c354-073e-4671-a4c3-7185ee10ea7a","value":{"kind":"end","message":"Building"}}}Content-Length: 93

{"jsonrpc":"2.0","method":"language/status","params":{"type":"Starting","message":"Init..."}}Content-Length: 118

{"jsonrpc":"2.0","method":"language/status","params":{"type":"Starting","message":"0% Starting Java Language Server"}}Content-Length: 126

{"jsonrpc":"2.0","id":"2","method":"window/workDoneProgress/create","params":{"token":"15cc8b15-5935-4448-9ead-554c7299deeb"}}Content-Length: 186

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"15cc8b15-5935-4448-9ead-554c7299deeb","value":{"kind":"begin","title":"Initialize Workspace","message":"Initialize Workspace"}}}Content-Length: 177

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"15cc8b15-5935-4448-9ead-554c7299deeb","value":{"kind":"report","message":"Initialize Workspace - 0% ","percentage":0}}}Content-Length: 2913

{"jsonrpc":"2.0","id":0,"result":{"capabilities":{"textDocumentSync":{"openClose":true,"change":2,"save":{"includeText":true}},"hoverProvider":true,"completionProvider":{"resolveProvider":true,"triggerCharacters":[".","@","#","*"," "]},"signatureHelpProvider":{"triggerCharacters":["(",","]},"definitionProvider":true,"typeDefinitionProvider":true,"implementationProvider":true,"referencesProvider":true,"documentHighlightProvider":true,"documentSymbolProvider":true,"workspaceSymbolProvider":true,"codeActionProvider":{"codeActionKinds":["quickfix","refactor","refactor.extract","refactor.inline","refactor.rewrite","source","source.organizeImports"],"resolveProvider":true},"codeLensProvider":{"resolveProvider":true},"documentFormattingProvider":true,"documentRangeFormattingProvider":true,"documentOnTypeFormattingProvider":{"firstTriggerCharacter":";","moreTriggerCharacter":["\n","}"]},"renameProvider":{"prepareProvider":true},"foldingRangeProvider":true,"declarationProvider":true,"executeCommandProvider":{"commands":["java.project.import","java.project.changeImportedProjects","java.navigate.openTypeHierarchy","java.project.resolveStackTraceLocation","java.edit.handlePasteEvent","java.edit.stringFormatting","java.project.getSettings","java.project.resolveWorkspaceSymbol","java.project.upgradeGradle","java.project.createModuleInfo","java.vm.getAllInstalls","java.edit.organizeImports","java.project.refreshDiagnostics","java.project.removeFromSourcePath","java.project.listSourcePaths","java.project.updateSettings","java.project.getAll","java.reloadBundles","java.project.isTestFile","java.project.resolveText","java.project.getClasspaths","java.navigate.resolveTypeHierarchy","java.edit.smartSemicolonDetection","java.project.updateSourceAttachment","java.project.updateClassPaths","java.decompile","java.protobuf.generateSources","java.project.resolveSourceAttachment","java.project.updateJdk","java.project.addToSourcePath","java.completion.onDidSelect"]},"workspace":{"workspaceFolders":{"supported":true,"changeNotifications":true},"fileOperations":{"willRename":{"filters":[{"pattern":{"glob":"**/*.java","matches":"file"},"scheme":"file"},{"pattern":{"glob":"**","matches":"folder"},"scheme":"file"}]}}},"typeHierarchyProvider":true,"callHierarchyProvider":true,"selectionRangeProvider":true,"semanticTokensProvider":{"legend":{"tokenTypes":["namespace","class","interface","enum","enumMember","type","typeParameter","method","property","variable","parameter","modifier","keyword","annotation","annotationMember","record","recordComponent"],"tokenModifiers":["abstract","static","readonly","deprecated","declaration","documentation","public","private","protected","native","generic","typeArgument","importDeclaration","constructor"]},"range":false,"full":{"delta":false},"documentSelector":[{"language":"java","scheme":"file"},{"language":"java","scheme":"jdt"}]},"inlayHintProvider":true}}}Content-Length: 126

{"jsonrpc":"2.0","id":"3","method":"window/workDoneProgress/create","params":{"token":"4682257e-18e5-4e11-aea6-8c8e80a9a84d"}}Content-Length: 214

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"4682257e-18e5-4e11-aea6-8c8e80a9a84d","value":{"kind":"begin","title":"Repository registry initialization","message":"Repository registry initialization"}}}Content-Length: 167

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"4682257e-18e5-4e11-aea6-8c8e80a9a84d","value":{"kind":"end","message":"Repository registry initialization"}}}Content-Length: 119

{"jsonrpc":"2.0","method":"language/status","params":{"type":"Starting","message":"10% Starting Java Language Server"}}Content-Length: 179

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"15cc8b15-5935-4448-9ead-554c7299deeb","value":{"kind":"report","message":"Initialize Workspace - 10% ","percentage":10}}}Content-Length: 93

{"jsonrpc":"2.0","method":"language/status","params":{"type":"ProjectStatus","message":"OK"}}Content-Length: 150

{"jsonrpc":"2.0","method":"language/status","params":{"type":"Starting","message":"100% Starting Java Language Server - Opening \u0027my-app\u0027."}}Content-Length: 159

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"15cc8b15-5935-4448-9ead-554c7299deeb","value":{"kind":"end","message":"Importing Maven project(s)"}}}Content-Length: 90

{"jsonrpc":"2.0","method":"language/status","params":{"type":"Started","message":"Ready"}}Content-Length: 150

{"jsonrpc":"2.0","method":"language/status","params":{"type":"Starting","message":"100% Starting Java Language Server - Opening \u0027my-app\u0027."}}Content-Length: 185

{"jsonrpc":"2.0","id":"4","method":"client/registerCapability","params":{"registrations":[{"id":"d5da1e18-cc28-41f3-86b3-d80769dd4fa1","method":"workspace/didChangeWorkspaceFolders"}]}}Content-Length: 102

{"jsonrpc":"2.0","method":"language/status","params":{"type":"ServiceReady","message":"ServiceReady"}}Content-Length: 126

{"jsonrpc":"2.0","id":"5","method":"window/workDoneProgress/create","params":{"token":"20de4b9d-9686-43d4-840f-51879a5938b2"}}Content-Length: 162

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"20de4b9d-9686-43d4-840f-51879a5938b2","value":{"kind":"begin","title":"Building","message":"Building"}}}Content-Length: 165

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"20de4b9d-9686-43d4-840f-51879a5938b2","value":{"kind":"report","message":"Building - 0% ","percentage":0}}}Content-Length: 141

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"20de4b9d-9686-43d4-840f-51879a5938b2","value":{"kind":"end","message":"Building"}}}Content-Length: 623

{"jsonrpc":"2.0","id":"6","method":"client/registerCapability","params":{"registrations":[{"id":"b3e6d8b2-d553-452e-8e79-7293a559e817","method":"workspace/didChangeWatchedFiles","registerOptions":{"watchers":[{"globPattern":"**/*.java"},{"globPattern":"**/.project"},{"globPattern":"**/.classpath"},{"globPattern":"**/.settings/*.prefs"},{"globPattern":"**/src/**"},{"globPattern":"**/*.gradle"},{"globPattern":"**/*.gradle.kts"},{"globPattern":"**/gradle.properties"},{"globPattern":"**/pom.xml"},{"globPattern":{"baseUri":"file:/Users/sjoerd/Projects/Java/helix-java-bug-report-setup/","pattern":"my-app"},"kind":4}]}}]}}Content-Length: 126

{"jsonrpc":"2.0","id":"7","method":"window/workDoneProgress/create","params":{"token":"bd23f4c0-1842-4097-ba14-2db22eb32dc1"}}Content-Length: 170

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"bd23f4c0-1842-4097-ba14-2db22eb32dc1","value":{"kind":"begin","title":"Searching...","message":"Searching..."}}}Content-Length: 169

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"bd23f4c0-1842-4097-ba14-2db22eb32dc1","value":{"kind":"report","message":"Searching... - 0% ","percentage":0}}}Content-Length: 1454

{"jsonrpc":"2.0","method":"textDocument/publishDiagnostics","params":{"uri":"file:///Users/sjoerd/Projects/Java/helix-java-bug-report-setup/my-app/src/test/java/com/example/AppTest.java","diagnostics":[{"range":{"start":{"line":4,"character":7},"end":{"line":4,"character":12}},"severity":1,"code":"268435846","source":"Java","message":"The import junit cannot be resolved"},{"range":{"start":{"line":10,"character":12},"end":{"line":10,"character":20}},"severity":1,"code":"16777218","source":"Java","message":"TestCase cannot be resolved to a type"},{"range":{"start":{"line":25,"character":18},"end":{"line":25,"character":22}},"severity":1,"code":"16777218","source":"Java","message":"Test cannot be resolved to a type"},{"range":{"start":{"line":27,"character":19},"end":{"line":27,"character":28}},"severity":1,"code":"16777218","source":"Java","message":"TestSuite cannot be resolved to a type"},{"range":{"start":{"line":35,"character":8},"end":{"line":35,"character":18}},"severity":1,"code":"67108964","source":"Java","message":"The method assertTrue(boolean) is undefined for the type AppTest"},{"range":{"start":{"line":2,"character":7},"end":{"line":2,"character":12}},"severity":1,"code":"268435846","source":"Java","message":"The import junit cannot be resolved"},{"range":{"start":{"line":3,"character":7},"end":{"line":3,"character":12}},"severity":1,"code":"268435846","source":"Java","message":"The import junit cannot be resolved"}]}}Content-Length: 126

{"jsonrpc":"2.0","id":"8","method":"window/workDoneProgress/create","params":{"token":"5687174f-03ad-4080-9997-df1871f42050"}}Content-Length: 182

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"5687174f-03ad-4080-9997-df1871f42050","value":{"kind":"begin","title":"Validate documents","message":"Validate documents"}}}Content-Length: 175

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"5687174f-03ad-4080-9997-df1871f42050","value":{"kind":"report","message":"Validate documents - 0% ","percentage":0}}}Content-Length: 151

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"5687174f-03ad-4080-9997-df1871f42050","value":{"kind":"end","message":"Validate documents"}}}Content-Length: 126

{"jsonrpc":"2.0","id":"9","method":"window/workDoneProgress/create","params":{"token":"900cfe3f-153e-4b43-a0a1-070081d46746"}}Content-Length: 184

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"900cfe3f-153e-4b43-a0a1-070081d46746","value":{"kind":"begin","title":"Publish Diagnostics","message":"Publish Diagnostics"}}}Content-Length: 176

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"900cfe3f-153e-4b43-a0a1-070081d46746","value":{"kind":"report","message":"Publish Diagnostics - 0% ","percentage":0}}}Content-Length: 404

{"jsonrpc":"2.0","method":"textDocument/publishDiagnostics","params":{"uri":"file:///Users/sjoerd/Projects/Java/helix-java-bug-report-setup/my-app/src/main/java/com/example/Main.java","diagnostics":[{"range":{"start":{"line":9,"character":21},"end":{"line":9,"character":30}},"severity":2,"code":"536870973","source":"Java","message":"The value of the local variable myStrings is not used","tags":[1]}]}}Content-Length: 152

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"900cfe3f-153e-4b43-a0a1-070081d46746","value":{"kind":"end","message":"Publish Diagnostics"}}}Content-Length: 190

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"bd23f4c0-1842-4097-ba14-2db22eb32dc1","value":{"kind":"report","message":"Searching... - 80% 1 files to index ()","percentage":79}}}Content-Length: 145

{"jsonrpc":"2.0","method":"$/progress","params":{"token":"bd23f4c0-1842-4097-ba14-2db22eb32dc1","value":{"kind":"end","message":"Searching..."}}}Content-Length: 36

{"jsonrpc":"2.0","id":1,"result":[]}Content-Length: 36

{"jsonrpc":"2.0","id":2,"result":[]}Content-Length: 36

{"jsonrpc":"2.0","id":3,"result":{}}Content-Length: 127

{"jsonrpc":"2.0","id":"10","method":"window/workDoneProgress/create","params":{"token":"581d06a7-a3c4-412b-83d9-af5796cd7df1"}}

Platform

MacOS Sequoia 15.5 (24F74)

Terminal Emulator

iTerm2

Installation Method

Homebrew

Helix Version

helix 25.07.1 (a05c151)

[the-mikedavis]

What does the Helix log look like when running in verbose mode and using gd? (hx -v --log log.txt and upload log.txt)

I expect that this is #11500 - for the standard library if the path is within an archive then we don't currently support opening the file. I expect that the response to the goto-definition response would have a zipfile://path/to/file URI

[sjoerdschouten]

@the-mikedavis See the log.txt here. I also updated the logs (both helix and jdtls) in the opening post.

Looking at the logs it seems to me that Helix just gets an empty list back from jdtls, see line 70 and 71 in the logs:

2025-08-04T20:04:45.514 helix_lsp::transport [INFO] jdtls -> {"jsonrpc":"2.0","method":"textDocument/definition","params":{"position":{"character":11,"line":9},"textDocument":{"uri":"file:///Users/sjoerd/Projects/Java/helix-java-bug-report-setup/my-app/src/main/java/com/example/Main.java"}},"id":2}
2025-08-04T20:04:45.620 helix_lsp::transport [INFO] jdtls <- {"jsonrpc":"2.0","id":2,"result":[]}

[quantonganh]

#8675 (comment)

[quantonganh]

@sjoerdschouten I wrote a wrapper to solve this problem. Please take a look if you're still interested: https://github.com/quantonganh/jdtls-wrapper

[sjoerdschouten]

I'll make sure to check it out, thanks!