Skip to content

Fix #11856: Improve error message for prefix-based remote repository filtering errors#11888

Draft
gnodet wants to merge 1 commit intomasterfrom
ci-issue-11856
Draft

Fix #11856: Improve error message for prefix-based remote repository filtering errors#11888
gnodet wants to merge 1 commit intomasterfrom
ci-issue-11856

Conversation

@gnodet
Copy link
Copy Markdown
Contributor

@gnodet gnodet commented Apr 3, 2026

Summary

  • Detect ArtifactFilteredOutException in the exception cause chain and append actionable guidance explaining that the remote repository's prefix file doesn't list the artifact's group
  • Suggest the workaround -Daether.remoteRepositoryFilter.prefixes=false and link to RRF documentation
  • Fix getReference() to return the RRF docs URL instead of the generic MojoExecutionException wiki page
  • Support https: reference URLs (previously only http: was recognized as an absolute URL)

Closes #11856

Test plan

  • Added DefaultExceptionHandlerTest.testArtifactFilteredOutException() verifying both the hint message and reference URL
  • Manual verification with a repository manager serving incomplete prefix files

🤖 Generated with Claude Code

Claude Code on behalf of Guillaume Nodet

…filtering errors

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@gnodet gnodet added this to the 4.0.0-rc-6 milestone Apr 3, 2026
Comment on lines +284 to +292
+ "This error indicates that the remote repository's prefix file does not list"
+ " this artifact's group. This commonly happens with repository managers"
+ " using virtual/group repositories that do not properly aggregate prefix files."
+ System.lineSeparator()
+ "To disable prefix-based filtering, add"
+ " -Daether.remoteRepositoryFilter.prefixes=false"
+ " to your command line or to .mvn/maven.config."
+ System.lineSeparator()
+ "See https://maven.apache.org/resolver/remote-repository-filtering.html";
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It can be also from GroupId Filter, so we need to use other property aether.remoteRepositoryFilter.groupId=false

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.

Regression "Prefix ... NOT allowed from ..."

2 participants