The requested URL was not found on this server error in Angular

You have built an Angular app and created a production build with ng build --prod You deploy it to a production server. Everything works fine until you refresh the page. The app throws The requested URL was not found on this server message (Status code 404 not found). It appears that angular routing not working on the production server when you refresh the page.

Applies to: Angular 2 to the latest edition of i.e. Angular 8. Angular 9, Angular 10

The error appears on the following scenarios

  1. When you type the URL directly in the address bar.
  2. When you refresh the page
  3. The error appears on all the pages except the root page.
  4. The error occurs only if you are using HTML 5 Routing or PathLocationStrategy

This is due to the fact that the Angular is a SPA (Single Page Application) framework.

Reason for the requested URL was not found on this server error

In a Multi-page web application, every time the application needs to display a page it has to send a request to the webserver. You can do that by either typing the URL in the address bar, clicking on the Menu link/ button. Every such action results in a new request being sent to the Web server. For each request, a corresponding page must exist on the server. The server locates that page and returns it back to the client.


Best Angular Books
The Top 8 Best Angular Books, which helps you to get started with Angular  

But in Angular Apps, the app starts when the main page (index.html) is loaded. Any subsequent requests do not reload the page but only load a part of the page. The requests are not sent to the server but handled by the Angular router at the client-side. You can read more about it from the article Angular bootstrap process

For Example, when you request for example.com the request is sent to the server, which returns the index.html.This will bootstrap the Angular.

Now when you click on example.com/products, the request is not sent to the server but handled at the client-side by the Angular Router. The Router loads the component associated with the products route. The products component may send an HTTP request to fetch the list of products to display. But the request to display the products page is never sent to the server.

What happens when somebody types the example.com/products in the address bar or refreshes the page. Now the request to fetch the products page is sent to the server. Since there is no products page available in the server it returns the The requested URL was not found on this server or 404 error page

Workaround

The workaround to this problem is to instruct the server to load the index.html no matter what. So when the request comes to example.com/products page, the server serves the index.html page. This bootstraps the Angular app and the Angular router is smart enough to read the requested URL and load the products component.

To instruct the server to load the index.html for every request require a configuration change at the Web server level. The configuration settings depend on the server used.

IIS Server

First, install the IIS URL Rewrite module. Copy the following to web.config file to the root of the application.

Apache

Add a rewrite rule to the .htaccess file as shown.

Nginx

Add the following try_files rules to the Nginx configuration file to redirect every request to serve index.html

References

Routed apps must fallback to index.html
Angular Bootstrap Process
Location strategies in Angular
Angular Router

3 thoughts on “The requested URL was not found on this server error in Angular”

Leave a Comment

Your email address will not be published.

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Scroll to Top