NG04014: Invalid configuration of route '{path: "", redirectTo: "produse"}': please provide 'pathMatch'. The default value of 'pathMatch' is 'prefix', but often the intent is to use 'full'.
O redirecționare cu path: '' nu are pathMatch. Adaugă pathMatch: 'full', ca redirecționarea să se aplice doar pentru adresa goală (pagina de start), nu pentru orice adresă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Routerul potrivește rutele pe segmente, iar pathMatch spune cum: 'prefix' (implicit) înseamnă „adresa începe cu acest path”, 'full' înseamnă „adresa este exact acest path”.
La path: '' diferența e mare: orice adresă începe cu textul gol, deci o redirecționare { path: '', redirectTo: 'produse' } cu prefix s-ar aplica la fiecare navigare, inclusiv la /contact. Pentru că aproape niciodată nu asta vrei, Angular refuză configurația și îți cere să alegi explicit. Mesajul îți spune și varianta dorită de obicei: often the intent is to use 'full'.
Eroarea apare la pornire, iar ruta problematică e afișată ca obiect, {path: "", redirectTo: "produse"}. Uneori e o rută copil, cu path: '' în interiorul unei secțiuni.
De ce apare: cauzele frecvente
1Redirecționarea paginii de start fără pathMatch
{ path: '', redirectTo: 'produse' }{ path: '', redirectTo: 'produse', pathMatch: 'full' }Cu 'full', redirecționarea se aplică doar când adresa e goală, adică pe pagina de start.
2Pagina implicită a unei secțiuni
{ path: 'cont', component: Cont, children: [
{ path: '', redirectTo: 'profil' },
{ path: 'profil', component: Profil }
] }{ path: 'cont', component: Cont, children: [
{ path: '', redirectTo: 'profil', pathMatch: 'full' },
{ path: 'profil', component: Profil }
] }Regula e aceeași la rutele copil: /cont ajunge la /cont/profil, iar /cont/comenzi nu e afectată.
Repară eroarea, direct în pagină
Pagina de start trebuie să ducă la lista de produse, dar aplicația se oprește cu „NG04014: ... please provide 'pathMatch'”. Repară redirecționarea ca la pornirea de la / adresa să devină /produse și să apară titlul „Produse”.
import { Component } from '@angular/core';
import { Routes, RouterOutlet } from '@angular/router';
@Component({ selector: 'app-produse', template: `<h2>Produse</h2><p>Mouse, tastatură, monitor.</p>` })
export class Produse {}
export const routes: Routes = [
{ path: '', redirectTo: 'produse' },
{ path: 'produse', component: Produse }
];
@Component({
selector: 'app-root',
imports: [RouterOutlet],
template: `<h1>IT Shop</h1><router-outlet />`
})
export class App {}Indiciu
La path: '' cu redirectTo, alege explicit cum se potrivește adresa.
Reparația
import { Component } from '@angular/core';
import { Routes, RouterOutlet } from '@angular/router';
@Component({ selector: 'app-produse', template: `<h2>Produse</h2><p>Mouse, tastatură, monitor.</p>` })
export class Produse {}
export const routes: Routes = [
{ path: '', redirectTo: 'produse', pathMatch: 'full' },
{ path: 'produse', component: Produse }
];
@Component({
selector: 'app-root',
imports: [RouterOutlet],
template: `<h1>IT Shop</h1><router-outlet />`
})
export class App {}De ce merge
Pentru path: '', potrivirea implicită prefix ar prinde orice adresă, deci redirecționarea ar fi greșită aproape mereu. Angular detectează cazul la pornire și aruncă NG04014 până când alegi explicit.
Cu pathMatch: 'full', ruta se potrivește doar când adresa este exact goală. La pornirea de la /, routerul înlocuiește adresa cu /produse și afișează componenta Produse, iar celelalte adrese rămân neatinse.
Alte forme ale mesajului
Error: NG04014: Invalid configuration of route '{path: "", redirectTo: "acasa"}': please provide 'pathMatch'. The default value of 'pathMatch' is 'prefix', but often the intent is to use 'full'.Invalid configuration of route '{path: "cont/", redirectTo: "profil"}': please provide 'pathMatch'.
Cum o eviți pe viitor
- Pune
pathMatch: 'full'la orice rută cupath: ''șiredirectTo; e și forma generată în documentația Angular. - Folosește
pathMatch: 'prefix'doar când chiar vrei ca ruta să prindă tot ce începe cu acel path. - Ține redirecționările la începutul listei și ruta
**la final, ca ordinea să fie ușor de citit.
Întrebări frecvente
De ce Angular nu pune singur 'full'?
Valoarea implicită pentru toate rutele este 'prefix' și ar fi o regulă ascunsă să se schimbe doar pentru path: ''. Angular preferă să te oblige să alegi explicit în acest caz, unde greșeala ar redirecționa toată aplicația.
Am nevoie de pathMatch și la rutele cu component?
De obicei nu: o rută cu component și path: 'produse' se potrivește corect cu prefix, iar restul adresei e potrivit de rutele copil. pathMatch: 'full' contează mai ales la redirecționări și la rute goale.
Erori înrudite
NG04014: Invalid configuration of route 'oferte': redirectTo and component/loadComponent cannot be used together O rută are în același timp redirectTo și component (sau loadComponent). O rută ori afișează o componentă, ori trimite în altă parte: păstrează doar una dintre ele. 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"). 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. Î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.
