This is an automated email from the ASF dual-hosted git repository.
oscerd pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/main by this push:
new 1f8a0def7f92 CAMEL-23651: sync muteException upgrade-guide entries
into 4_18/4_14 guides on main
1f8a0def7f92 is described below
commit 1f8a0def7f922b4f4f469807df42247370a78d0a
Author: Andrea Cosentino <[email protected]>
AuthorDate: Mon Jun 15 10:32:53 2026 +0200
CAMEL-23651: sync muteException upgrade-guide entries into 4_18/4_14 guides
on main
The muteException default flip (camel-netty-http / camel-undertow) was
backported
to camel-4.18.x (#23923, 4.18.3) and camel-4.14.x (#23990, 4.14.8), with the
upgrade-guide notes added to the per-release guides on those maintenance
branches.
Per the backport upgrade-guide policy, the version-specific
camel-4x-upgrade-guide-4_XX.adoc files on main are the canonical history
across all
releases, so the same entries must also live on main. This adds the
camel-netty-http
/ camel-undertow muteException note to main's 4_18 guide (Upgrading from
4.18.1 to
4.18.3) and 4_14 guide (Upgrading from 4.14.3 to 4.14.8), which were
missing it.
Docs-only; no code or generated files affected.
Signed-off-by: Andrea Cosentino <[email protected]>
---
.../ROOT/pages/camel-4x-upgrade-guide-4_14.adoc | 25 ++++++++++++++++++++++
.../ROOT/pages/camel-4x-upgrade-guide-4_18.adoc | 25 ++++++++++++++++++++++
2 files changed, 50 insertions(+)
diff --git
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_14.adoc
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_14.adoc
index 0279ae2e55a6..5fe9b32ad287 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_14.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_14.adoc
@@ -13,6 +13,31 @@ See the xref:camel-upgrade-recipes-tool.adoc[documentation]
page for details.
== Upgrading from 4.14.3 to 4.14.8
+=== camel-netty-http / camel-undertow - potential breaking change
+
+The `muteException` consumer option now defaults to `true` in
`camel-netty-http` and
+`camel-undertow`, aligning these components with the other HTTP server
components
+(`camel-http`, `camel-jetty`, `camel-servlet`, and `camel-platform-http`),
which have
+been defaulting `muteException` to `true` for a long time.
+
+When an exchange fails processing on the consumer side, the HTTP response now
has an
+empty body. Previously the response body contained the exception stack trace as
+`text/plain`.
+
+Routes that rely on the exception stack trace being present in the response
body must
+set `muteException=false` explicitly on the endpoint or component after the
upgrade:
+
+[source,text]
+----
+netty-http:http://0.0.0.0:8080/foo?muteException=false
+undertow:http://0.0.0.0:8080/foo?muteException=false
+----
+
+Note that `muteException` takes precedence over `transferException`, as it
already does
+in the other HTTP server components. Routes using `transferException=true` on
these two
+components must now also set `muteException=false` for the serialized
exception to be
+returned in the response.
+
=== camel-core
The `org.apache.camel.support.DefaultHeaderFilterStrategy` changed default
setting for lowercase from `false` to `true`.
diff --git
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
index 46d8dff881b8..4469e95d457c 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
@@ -13,6 +13,31 @@ See the xref:camel-upgrade-recipes-tool.adoc[documentation]
page for details.
== Upgrading from 4.18.1 to 4.18.3
+=== camel-netty-http / camel-undertow - potential breaking change
+
+The `muteException` consumer option now defaults to `true` in
`camel-netty-http` and
+`camel-undertow`, aligning these components with the other HTTP server
components
+(`camel-http`, `camel-jetty`, `camel-servlet`, and `camel-platform-http`),
which have
+been defaulting `muteException` to `true` for a long time.
+
+When an exchange fails processing on the consumer side, the HTTP response now
has an
+empty body. Previously the response body contained the exception stack trace as
+`text/plain`.
+
+Routes that rely on the exception stack trace being present in the response
body must
+set `muteException=false` explicitly on the endpoint or component after the
upgrade:
+
+[source,text]
+----
+netty-http:http://0.0.0.0:8080/foo?muteException=false
+undertow:http://0.0.0.0:8080/foo?muteException=false
+----
+
+Note that `muteException` takes precedence over `transferException`, as it
already does
+in the other HTTP server components. Routes using `transferException=true` on
these two
+components must now also set `muteException=false` for the serialized
exception to be
+returned in the response.
+
=== camel-keycloak
The `KeycloakSecurityPolicy` route policy now always verifies the access token
when one is present - signature,
