Allow forcing exception unwrapping even when parent type mappers exist #50730

kevinferrare-1a · 2025-10-27T09:13:08Z

Adds support for the strategy attribute in @UnwrapException annotation to control exception unwrapping behaviour.

This makes tests in the reproducer pass with following annotation:

@UnwrapException(value={ WebApplicationException.class }, strategy=ExceptionUnwrapStrategy.UNWRAP_IF_NO_EXACT_MATCH)

https://github.com/user-attachments/files/20574949/quarkus-48197-reproducer.zip

Main Changes:

Added strategy boolean parameter to @UnwrapException annotation (default: UNWRAP_IF_NO_MATCH) and propagated it.
Updated RuntimeExceptionMapper exception mapping strategy to handle it:
- If strategy=ALWAYS, unwrap even if exception is directly mapped in a mapper
- If strategy=UNWRAP_IF_NO_EXACT_MATCH and exception is not directly mapped anywhere, unwrap
- If strategy=UNWRAP_IF_NO_MATCH, check if the exception or one of its subtypes is mapped (existing behaviour)
- If exception couldnt be mapped, unwrap it and repeat the process for the wrapped exception (existing behaviour)
Reworked UnwrappedExceptionTest to add more cases and more explicit names, and achieve 100% coverage on new code in RuntimeExceptionMapper.
Closes: UnwrapException ineffective when a subclass of the declared exception is mapped via ServerExceptionMapper #48197

github-actions · 2025-10-27T10:11:45Z

🎊 PR Preview 7e4f124 has been successfully built and deployed to https://quarkus-pr-main-50730-preview.surge.sh/version/main/guides/

Images of blog posts older than 3 months are not available.
Newsletters older than 3 months are not available.

quarkus-bot · 2025-11-07T15:11:25Z

Status for workflow `Quarkus Documentation CI`

This is the status report for running Quarkus Documentation CI on commit 47682be.

✅ The latest workflow run for the pull request has completed successfully.

It should be safe to merge provided you have a look at the other checks in the summary.

Warning

There are other workflow runs running, you probably need to wait for their status before merging.

quarkus-bot · 2025-11-07T16:18:19Z

Status for workflow `Quarkus CI`

This is the status report for running Quarkus CI on commit 47682be.

✅ The latest workflow run for the pull request has completed successfully.

It should be safe to merge provided you have a look at the other checks in the summary.

You can consult the Develocity build scans.

Flaky tests - Develocity

⚙️ JVM Tests - JDK 25

📦 extensions/smallrye-graphql/deployment

❌ io.quarkus.smallrye.graphql.deployment.CompletionStageTest.testSourcePost - History

1 expectation failed. Expected status code <200> but was <500>. - java.lang.AssertionError

java.lang.AssertionError: 
1 expectation failed.
Expected status code <200> but was <500>.

	at java.base/jdk.internal.reflect.DirectConstructorHandleAccessor.newInstance(DirectConstructorHandleAccessor.java:62)
	at java.base/java.lang.reflect.Constructor.newInstanceWithCaller(Constructor.java:499)
	at java.base/java.lang.reflect.Constructor.newInstance(Constructor.java:483)
	at org.codehaus.groovy.reflection.CachedConstructor.invoke(CachedConstructor.java:73)

geoand · 2025-11-08T07:46:12Z

...er/runtime/src/main/java/org/jboss/resteasy/reactive/server/core/RuntimeExceptionMapper.java

+                () -> searchMapperForExceptionsToUnwrap(clazz, mappers, throwable, ExceptionUnwrapStrategy.ALWAYS),
+                // If the exception type is directly mapped, ignore the unwrapping.
+                () -> buildMapperEntryIfExists(clazz, mappers, throwable),
+                // Check if the exception should be unwrapped if no exact match (if strategy=UNWRAP_IF_NO_EXACT_MATCH).
+                () -> searchMapperForExceptionsToUnwrap(clazz, mappers, throwable,
+                        ExceptionUnwrapStrategy.UNWRAP_IF_NO_EXACT_MATCH),
+                // Walk up the class hierarchy looking for a mapper for the type
+                () -> searchMapperInClassHierarchy(clazz, mappers, throwable),
+                // If no mapper found and exception is marked for unwrapping (if strategy=UNWRAP_IF_NO_MATCH), unwrap it
+                () -> searchMapperForExceptionsToUnwrap(clazz, mappers, throwable, ExceptionUnwrapStrategy.UNWRAP_IF_NO_MATCH));


We try hard to avoid lambdas in code that executes at runtime. Can you please update the code to remove them?

quarkus-bot bot added area/documentation area/rest labels Oct 27, 2025