MuleSoft · HTTP Connector

HTTP:SERVICE_UNAVAILABLE

Short answer

HTTP:SERVICE_UNAVAILABLE means the server could not handle the request because it is down for maintenance or overloaded (HTTP 503). The fault is on the remote side, so retry after a delay and handle the error if the service stays down.

VerifiedLast verified

01Error text

MuleSoft error
Error type: HTTP:SERVICE_UNAVAILABLE

02Likely causes

  • The server is unable to manage the request because it is down for maintenance or overloaded.
  • HTTP Connector treats any status code from 500 through 599 as a failure and raises an error.

03How to fix it

  1. Check the status of the remote service. This error is raised by the response it sent, not by your Mule app.
  2. If the service is overloaded by your own traffic, reduce it by setting maxConcurrency on the calling flow.
  3. Retry after a delay: wrap the request in an Until Successful scope and set maxRetries and millisBetweenRetries.
  4. Handle the failure with an error handler of type HTTP:SERVICE_UNAVAILABLE for the case where every retry fails.

04Official documentation

Test every fix in a non-production environment before you apply it to production. See how entries are verified.

More for MuleSoft work:Open MuleSoft jobsMuleSoft rates and salariesHire a senior MuleSoft developer

The iPaaS Brief

Subscribe to The iPaaS Brief.

The iPaaS newsletter for the people who run integrations. From iPaaS Group.

Free. You finish on theipaasbrief.com and confirm by email.