3 simple rules & 5 examples to understand the Error Handling in Mule 4

Updated: Sep 4



Hey Muleys,


I believe that this article on Error Handling in Mule 4 will definitely help you to understand the core concept of On-Error Propagate and On-Error Continue.



What is Error Handling?


An exception occurs when an unexpected event happens while processing. Exception (or error) handling is the process of responding to exceptions when a computer program runs.


In Mule, we can handle the message exception at different levels.

  • At project level using the Default error handler

  • At project level using the Custom Global error handler

  • At flow level in exception handling using the Raise Error component, On-Error Continue and On-Error Propagate.

  • At flow or at processor level using the Try scope.


Whenever an error occurs in a flow, an error object is created. It contains many properties, like error.description or error.errorType.


The errorType property is a combination of Namespace and Identifier. For example, HTTP:UNAUTHORIZED, where the Namespace is HTTP and the Identifier is UNAUTHORIZED.


Mule identifies the error based on the errorType and then routes it to its respective block that is placed inside the Error Handler.



What is On-Error Propagate and On-Error Continue?


The difference between a flow, a sub-flow and a private flow, is that sub-flow doesn’t have an Error Handling scope. So, it's just flow and private flow the ones that have an Error Handling block and can contain the On-Error Propagate and On-Error Continue.


Whether it is Propagate or Continue, Mule Executes all the components within those blocks.

Remember: The error will route to the Error Handling only if it identifies that the errorType from the error matches with what you have set in your Error Handling block.


Mule 4 has one excellent feature that can identify the types of errors that can occur within that flow by looking at what kind of connectors are placed in that particular flow.



You can see above that, since we have an HTTP Request and Database components, the drop-down shows all the types of errors that can happen in different scenarios from these two components. It even shows the EXPRESSION error type (not in the picture) because there are some DataWeave syntaxes in the flow.


It will be very easy to learn Error Handling by knowing how On-Error Propagate and On-Error Continue work. We shall follow some set of rules to identify the flow of process. That way we can determine what is the result payload statusCode.