redhat-developer / redhat-developer/vscode-java

JDT LS fails to resolve lombok.config in single-folder Maven projects

Open
#4,461 1 comment 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

bug
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

  1. Create or open a Maven multi-module project with a lombok.config file at the project root directory
  2. Open the project via VSCode's "Open Folder" (single-folder mode, NOT workspace mode)
  3. Configure lombok.config with non-default settings, e.g.:
    lombok.accessors.chain=true
    lombok.tostring.callsuper=CALL
    lombok.equalsandhashcode.callsuper=CALL
    
  4. Create a class with @Data annotation and verify:
    • Setters should return this (chain = true) but they return void (default behavior)
    • toString() should call super.toString() but it doesn't
  5. Run mvn clean compile from 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-workspace file (workspace mode): lombok.config loads correctly
  • mvn clean compile from command line: compiles correctly with all lombok.config settings applied
What does NOT work (all attempted and failed)
  1. Lombok version upgrade: Using 1.18.46, well above the 1.18.28 fix for Eclipse 4.27 compatibility (issue #2887)
  2. Manual -javaagent injection: Setting java.jdt.ls.vmargs to -javaagent:<path>/lombok-1.18.46.jar in .vscode/settings.json — no effect
  3. Disabling built-in Lombok support: Setting java.jdt.ls.lombokSupport.enabled: false + manual javaagent — no effect
  4. Copying lombok.config to src/main/java/: No effect
  5. Removing config.stopBubbling: No effect
  6. Java: Clean Java Language Server Workspace after 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
  • #2887lombok.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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.