Skip to content

Fix false positive UnrecognisedJavadocTag with Lombok annotations#5956

Open
ayushkumar9449 wants to merge 1 commit into
google:masterfrom
ayushkumar9449:fix/lombok-false-positive-javadoc
Open

Fix false positive UnrecognisedJavadocTag with Lombok annotations#5956
ayushkumar9449 wants to merge 1 commit into
google:masterfrom
ayushkumar9449:fix/lombok-false-positive-javadoc

Conversation

@ayushkumar9449

Copy link
Copy Markdown

Fixes #5855 - UnrecognisedJavadocTag checker was reporting false positives when Lombok annotations (@Getter, @Setter, etc.) were present on classes or fields with valid {@link} or {@code} Javadoc tags.

Root cause: Annotation-related position offsets in the AST caused position mismatches between regex-found tags and DocTree-recognized tags, resulting in false positives.

Solution: Added validation to check if tags are well-formed (end with '}'). Only report errors for genuinely malformed tags, not position mismatches due to annotation offsets.

  • Modified: UnrecognisedJavadocTag.java
    • Added isValidTag() method to check tag structure
    • Updated handle() to skip reporting for well-formed tags with position mismatches
  • Added test cases for Lombok @Getter on both class and field level

Fixes google#5855 - UnrecognisedJavadocTag checker was reporting false positives
when Lombok annotations (@Getter, @Setter, etc.) were present on classes
or fields with valid {&google#64;link} or {&google#64;code} Javadoc tags.

Root cause: Annotation-related position offsets in the AST caused position
mismatches between regex-found tags and DocTree-recognized tags, resulting
in false positives.

Solution: Added validation to check if tags are well-formed (end with '}').
Only report errors for genuinely malformed tags, not position mismatches
due to annotation offsets.

- Modified: UnrecognisedJavadocTag.java
  * Added isValidTag() method to check tag structure
  * Updated handle() to skip reporting for well-formed tags with position mismatches
- Added test cases for Lombok @Getter on both class and field level
@google-cla

google-cla Bot commented Jul 14, 2026

Copy link
Copy Markdown

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2.50.0 false positive UnrecognisedJavadocTag with Lombok

1 participant