redhat-developer / redhat-developer/vscode-java
JDT LS fails to resolve lombok.config in single-folder Maven projects
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 2.3k
- Forks
- 546
- Avg merge
- 20h 1m
- Merged PRs (30d)
- 11
Description
Bug Report Issue: lombok.config not loaded in single-folder Maven project
Describe the bug
When opening a Maven multi-module project via VSCode's "Open Folder" (single-folder mode), the lombok.config file at the project root is completely ignored. Lombok annotations work (e.g., @Data, @Getter), but all settings in lombok.config (such as lombok.accessors.chain=true, lombok.tostring.callsuper=CALL) are not applied. The editor shows errors where it shouldn't, e.g., setter methods not returning this for chaining, or toString() not calling super.toString().
The project compiles fine from command line (mvn clean compile passes without errors), which confirms the lombok.config file itself is correct and Maven picks it up properly. The issue is exclusively within the JDT Language Server's handling of lombok.config in VSCode's single-folder mode.
Notably, opening the same project via .code-workspace file (workspace mode) works correctly — lombok.config is loaded and all settings take effect.
To Reproduce
- Create or open a Maven multi-module project with a
lombok.configfile at the project root directory - Open the project via VSCode's "Open Folder" (single-folder mode, NOT workspace mode)
- Configure
lombok.configwith non-default settings, e.g.:lombok.accessors.chain=true lombok.tostring.callsuper=CALL lombok.equalsandhashcode.callsuper=CALL - Create a class with
@Dataannotation and verify:- Setters should return
this(chain = true) but they returnvoid(default behavior) toString()should callsuper.toString()but it doesn't
- Setters should return
- Run
mvn clean compilefrom terminal — this works correctly, confirming the config file is valid
Expected behavior
lombok.config at the project root should be discovered and applied by JDT LS, even in single-folder mode. All configured settings (chain, callsuper, etc.) should take effect in the editor's language features.
Environment
| Item | Value |
|---|---|
| Operating System | Windows 11 Home Chinese Edition (Version 2009) |
| JDK | Oracle GraalVM 21.0.10+8.1 (build 21.0.10+8-LTS-jvmci-23.1-b84) |
| Visual Studio Code | 1.128.0 (x64) |
| Java Extension (redhat.java) | 1.55.0 |
| Java Extension Pack | 0.31.1 |
| Lombok version | 1.18.46 |
| Project type | Maven multi-module (ruoyi-vue-pro) |
Additional Information
What works
- Opening the project via
.code-workspacefile (workspace mode):lombok.configloads correctly mvn clean compilefrom command line: compiles correctly with all lombok.config settings applied
What does NOT work (all attempted and failed)
- Lombok version upgrade: Using 1.18.46, well above the 1.18.28 fix for Eclipse 4.27 compatibility (issue #2887)
- Manual
-javaagentinjection: Settingjava.jdt.ls.vmargsto-javaagent:<path>/lombok-1.18.46.jarin.vscode/settings.json— no effect - Disabling built-in Lombok support: Setting
java.jdt.ls.lombokSupport.enabled: false+ manual javaagent — no effect - Copying
lombok.configtosrc/main/java/: No effect - Removing
config.stopBubbling: No effect Java: Clean Java Language Server Workspaceafter each change: No effect
Suspected root cause
Based on Lombok source code analysis (FileSystemSourceCache.forUri() and EclipseAST.getAbsoluteFileLocation()), the issue likely lies in how JDT LS resolves the source file URI in single-folder mode. In workspace mode, the .code-workspace file provides a clear project root context, allowing JDT LS to pass correct absolute file paths to Lombok. In single-folder mode, the Invisible Project mechanism may resolve URIs differently, causing Lombok's lombok.config discovery (which walks up from the source file's parent directory) to never reach the actual project root directory where lombok.config resides.
Related issues
- #2887 —
lombok.config ignored in 1.14.0(fixed in Lombok 1.18.28 for Eclipse 4.27 compatibility) - projectlombok/lombok#3332 — The upstream Lombok fix for Eclipse 4.27
lombok.config content
lombok.tostring.callsuper=CALL
lombok.equalsandhashcode.callsuper=CALL
lombok.accessors.chain=true
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by tracing Lombok's FileSystemSourceCache.forUri() and EclipseAST.getAbsoluteFileLocation() through JDT LS's single-folder and Invisible Project handling. Compare the source file URIs and project-root resolution with workspace mode; the issue is done when the root lombok.config is discovered in single-folder mode and its settings affect editor language features.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- java, vscode
- Domain
- devtools, tooling
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100