NG04002: Cannot match any routes. URL Segment: 'contact'
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
export const routes: Routes = [
{ path: '', component: Acasa }
];
// <a routerLink="/contact">Contact</a>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
{ path: 'produse', component: Produse }
// <a routerLink="/produs">Produse</a>{ 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ă
{ path: 'cont', component: Cont, children: [
{ path: 'comenzi', component: Comenzi }
] }
// <a routerLink="/comenzi">Comenzi</a>// <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ă 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.
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.
Reparația
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 },
{ path: 'contact', component: Contact }
];
@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 {}De ce merge
Routerul ia adresa /contact, o împarte în segmente și caută în Routes un obiect cu path: 'contact'. Fără el, nu are ce componentă să pună în <router-outlet />, așa că anulează navigarea și aruncă NG04002 cu segmentul pe care nu l-a găsit.
După ce adaugi { path: 'contact', component: Contact }, potrivirea reușește: adresa se schimbă, iar componenta Contact apare în outlet. Linkul și ruta trebuie să folosească exact același text.
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
NG04014: Invalid configuration of route '/contact': path cannot start with a slash În Routes ai scris path: '/contact' cu slash la început. Căile din configurație sunt relative și se scriu fără /: path: 'contact'. Slash-ul îl pui doar în linkuri (routerLink="/contact"). NG0303: Can't bind to 'routerLink' since it isn't a known property of 'a' (used in the 'App' component template). Folosești [routerLink] într-o componentă care nu importă directiva RouterLink. Adaugă RouterLink (din @angular/router) în imports: [...] din @Component; altfel linkul nu navighează. NG0304: 'router-outlet' is not a known element (used in the 'App' component template) Componenta folosește <router-outlet /> în șablon, dar nu are RouterOutlet în imports. Adaugă RouterOutlet (din @angular/router) în imports: [...] din @Component; altfel paginile nu apar deloc. Î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.
