...
Eroare Angular · Router și navigare

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'.

Pe scurt

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

Greșit
TypeScript
{ path: '', redirectTo: 'produse' }
Corect
TypeScript
{ 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

Greșit
TypeScript
{ path: 'cont', component: Cont, children: [
  { path: '', redirectTo: 'profil' },
  { path: 'profil', component: Profil }
] }
Corect
TypeScript
{ 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ă tu

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”.

Codul care dă eroarea
TypeScript
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.

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ă cu path: '' și redirectTo; 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

← 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.