---
title: "How to handle exceptions globally in a .NET Core API using middleware?"  
description: "How to handle exceptions globally in a .NET Core API using middleware?"  
author: "Utpal Vishwas"  
published: 2023-08-30  
updated: 2023-09-02  
canonical: https://www.mindstick.com/forum/159755/how-to-handle-exceptions-globally-in-a-dot-net-core-api-using-middleware  
category: ".net core"  
tags: ["exception handling", "exception", "asp.net core", ".net core"]  
reading_time: 2 minutes  

---

# How to handle exceptions globally in a .NET Core API using middleware?

How to [handle exceptions](https://www.mindstick.com/forum/159234/how-do-you-handle-exceptions-using-the-try-catch-block-in-java) globally in a .NET [Core API](https://www.mindstick.com/forum/160547/how-to-pass-multiple-parameters-in-url-dot-net-core-api) using [middleware](https://www.mindstick.com/forum/159733/what-is-the-role-of-middleware-in-dot-net-core-web-api)?

## Replies

### Reply by Aryan Kumar

To [handle](https://www.mindstick.com/articles/311004/suede-skillet-handle-cover) [exceptions](https://www.mindstick.com/interview/22871/define-predifined-generic-exceptions) globally in a .NET Core [API](https://www.mindstick.com/articles/12641/instagram-api-upgraded-to-facebook-graph) using middleware, you can use the `UseExceptionHandler` middleware. The `UseExceptionHandler` middleware catches all unhandled exceptions and redirects them to a handler that you specify.

To use the `UseExceptionHandler` middleware, you need to add it to the middleware pipeline in your Startup class. The following code shows how to do this:

C#

```plaintext
public void Configure(IApplicationBuilder app) {
  app.UseExceptionHandler("/error");
  // Other middleware...
}
```

The `/error` route is the route that the `UseExceptionHandler` middleware will redirect to when it catches an unhandled exception. You can customize the route by passing a different value to the `UseExceptionHandler` method.

The handler that you specify for the `UseExceptionHandler` middleware is responsible for handling the unhandled exceptions. The following code shows a simple example of a handler that logs the exception to the console:

C#

```plaintext
app.UseExceptionHandler("/error")
  .Run(async (context, exception) => {
    context.Response.StatusCode = 500;
    context.Response.ContentType = "application/json";
    context.Response.WriteAsync(JsonConvert.SerializeObject(exception));
  });
```

This handler sets the response status code to 500 (Internal Server Error) and the response content type to "application/json". The handler then serializes the exception object to JSON and writes it to the response stream.

You can customize the handler to do whatever you want with the unhandled exception. For example, you could send an email notification to the developers, or you could retry the operation a few seconds later.

By using the `UseExceptionHandler` middleware, you can ensure that all unhandled exceptions are handled gracefully in your .NET Core API. This will help you to improve the reliability of your application and provide a better experience for your users.

Here are some additional tips for handling exceptions globally in a .NET Core API using middleware:

- Use a try-catch block to handle exceptions in your code. This will allow you to catch and handle exceptions before they reach the `UseExceptionHandler` middleware.
- Log the exception to a file or database. This will help you to track down the cause of the error.
- Retry the operation if the exception is transient. For example, if the database is unavailable, you can retry the operation a few seconds later.

By following these tips, you can ensure that your .NET Core API can handle exceptions gracefully and provide a good user experience.


---

Original Source: https://www.mindstick.com/forum/159755/how-to-handle-exceptions-globally-in-a-dot-net-core-api-using-middleware

Copyright © MindStick Software Pvt. Ltd. This Markdown version is provided for developers, AI systems, and offline reading.