...
Eroare Angular · Router și navigare

NG04002: Cannot match any routes. URL Segment: 'contact'

Pe scurt

Routerul a primit o adresă (aici /contact) pentru care nu există nicio rută în configurație. Adaugă ruta lipsă în Routes, corectează linkul sau pune la final o rută '**' pentru pagina 404.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Mesajul vine de la Router-ul Angular, în momentul în care încearcă să potrivească adresa cerută cu lista ta de rute. Cannot match any routes înseamnă că a parcurs toate obiectele din Routes (în ordine, inclusiv children) și niciunul nu se potrivește. URL Segment: 'contact' îți arată bucata din adresă la care s-a oprit: de acolo începe partea pe care nu o recunoaște.

Apare când dai click pe un routerLink, când apelezi router.navigate(...) sau când deschizi direct adresa în browser. Navigarea e anulată, iar eroarea ajunge în consolă ca Uncaught (in promise), pentru că navigarea este o promisiune respinsă.

Cele mai dese motive: ruta chiar lipsește, numele din link diferă de path (contacte față de contact), o rută copil e căutată la rădăcină, sau un link relativ duce în alt loc decât credeai. Compară segmentul din mesaj cu fiecare path din configurație.

De ce apare: cauzele frecvente

1Ruta nu există în configurație

Greșit
TypeScript
export const routes: Routes = [
  { path: '', component: Acasa }
];
// <a routerLink="/contact">Contact</a>
Corect
TypeScript
export const routes: Routes = [
  { path: '', component: Acasa },
  { path: 'contact', component: Contact }
];

Routerul cunoaște doar adresele din Routes. După ce adaugi ruta contact, linkul are unde să ducă.

2Numele din link diferă de path

Greșit
TypeScript
{ path: 'produse', component: Produse }
// <a routerLink="/produs">Produse</a>
Corect
TypeScript
{ path: 'produse', component: Produse }
// <a routerLink="/produse">Produse</a>

Potrivirea se face exact, literă cu literă. produs și produse sunt două adrese diferite.

3Rută copil cerută ca rută de rădăcină

Greșit
TypeScript
{ path: 'cont', component: Cont, children: [
  { path: 'comenzi', component: Comenzi }
] }
// <a routerLink="/comenzi">Comenzi</a>
Corect
TypeScript
// <a routerLink="/cont/comenzi">Comenzi</a>
// sau, în interiorul componentei Cont:
// <a routerLink="comenzi">Comenzi</a>

O rută din children există doar sub părintele ei: adresa completă este /cont/comenzi.

Repară tu

Repară eroarea, direct în pagină

Meniul are un link #l-contact către /contact, dar la click consola arată „NG04002: Cannot match any routes. URL Segment: 'contact'”. Adaugă ruta lipsă ca pagina Contact (titlul h2 „Contactează-ne”) să apară sub meniu, iar adresa să devină /contact.

Codul care dă eroarea
TypeScript
import { Component } from '@angular/core';
import { Routes, RouterOutlet, RouterLink } from '@angular/router';

@Component({ selector: 'app-acasa', template: `<h2>Flori proaspete în fiecare zi</h2>` })
export class Acasa {}

@Component({ selector: 'app-contact', template: `<h2>Contactează-ne</h2><p>Str. Lalelelor 7, Sibiu</p>` })
export class Contact {}

export const routes: Routes = [
  { path: '', component: Acasa }
];

@Component({
  selector: 'app-root',
  imports: [RouterOutlet, RouterLink],
  template: `
    <nav>
      <a id="l-acasa" routerLink="/">Acasă</a>
      <a id="l-contact" routerLink="/contact">Contact</a>
    </nav>
    <router-outlet />
  `
})
export class App {}
Indiciu

Fiecare adresă la care duce un link are nevoie de un obiect în Routes.

Alte forme ale mesajului

  • ERROR Error: Uncaught (in promise): Error: NG04002: Cannot match any routes. URL Segment: 'contact'
  • Error: NG04002: Cannot match any routes. URL Segment: 'admin/rapoarte'
  • Error: Cannot match any routes. URL Segment: 'contact'

Cum o eviți pe viitor

  • Ține toate adresele în configurație și folosește aceleași texte în routerLink (eventual constante pentru căile importante).
  • Adaugă la final o rută { path: '**', component: PaginaNegasita }: orice adresă necunoscută ajunge pe o pagină 404 în loc de o eroare.
  • La rutele copil, gândește adresa completă (/cont/comenzi) sau folosește linkuri relative din componenta părinte.
  • După ce redenumești o rută, caută în proiect vechiul nume (în șabloane și în navigate).

Întrebări frecvente

De ce apare Uncaught (in promise) în fața mesajului?

Navigarea în Angular întoarce o promisiune. Când potrivirea eșuează, promisiunea e respinsă, iar dacă nimeni nu o tratează browserul o raportează ca Uncaught (in promise). Cauza reală e tot ruta lipsă.

Cum fac o pagină 404 în loc de eroare?

Pune ultima în listă ruta { path: '', component: PaginaNegasita }. Ordinea contează: se potrivește cu orice, deci rutele puse după ea nu mai sunt atinse niciodată.

Pe server merge, dar la refresh primesc 404 de la server. E aceeași eroare?

Nu. Acela e serverul web, care nu știe de rutele Angular și trebuie configurat să trimită index.html pentru orice adresă. NG04002 apare în browser, când routerul Angular nu găsește ruta.

Erori înrudite

← Toate erorile Angular

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Angular de la zero, cu exerciții la fiecare lecție

Curs Angular: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.