NG04014: Invalid configuration of route 'rapoarte'. The component must be standalone.
loadComponent a întors ceva care nu e o componentă standalone: de obicei tot modulul importat (lipsește .then(m => m.Rapoarte)) sau o componentă declarată într-un NgModule. Întoarce clasa componentei.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
loadComponent trebuie să întoarcă o promisiune cu clasa unei componente standalone. Routerul așteaptă promisiunea, verifică ce a primit și, dacă nu e o componentă standalone, oprește navigarea cu acest NG04014.
Cea mai frecventă cauză este loadComponent: () => import('./rapoarte') fără .then(...). import() întoarce modulul (obiectul cu toate exporturile fișierului), nu clasa. Angular știe să ia singur exportul implicit (export default class Rapoarte), dar dacă fișierul are doar exporturi cu nume, primește obiectul modulului și îl respinge.
A doua cauză apare în proiectele mai vechi: componenta are standalone: false și e declarată într-un NgModule. Pentru astfel de componente se folosește loadChildren cu modulul, nu loadComponent. Eroarea apare abia la prima navigare spre ruta leneșă, nu la pornire.
De ce apare: cauzele frecvente
1import() fără then
{ path: 'rapoarte', loadComponent: () => import('./rapoarte') }{ path: 'rapoarte', loadComponent: () => import('./rapoarte').then(m => m.Rapoarte) }.then(m => m.Rapoarte) scoate clasa din modulul încărcat; routerul primește exact componenta.
2Export implicit lipsă
// rapoarte.ts
export class Rapoarte {}
// rute
loadComponent: () => import('./rapoarte')// rapoarte.ts
export default class Rapoarte {}
// rute
loadComponent: () => import('./rapoarte')Fără .then, Angular folosește exportul default; cu export default, forma scurtă funcționează.
3Componentă dintr-un NgModule
@Component({ standalone: false, ... })
export class Rapoarte {}
// loadComponent: () => import('./rapoarte').then(m => m.Rapoarte)@Component({ selector: 'app-rapoarte', template: '...' })
export class Rapoarte {}loadComponent acceptă doar componente standalone (implicit din Angular 19). Pentru module se folosește loadChildren.
Repară eroarea, direct în pagină
Pagina de rapoarte se încarcă leneș din fișierul rapoarte.ts (care exportă clasa Rapoarte), dar la /rapoarte apare „NG04014: Invalid configuration of route 'rapoarte'. The component must be standalone.” Repară ruta ca să apară titlul „Rapoarte lunare”, păstrând încărcarea leneșă.
import { Component } from '@angular/core';
import { Routes, RouterOutlet } from '@angular/router';
export const routes: Routes = [
{ path: 'rapoarte', loadComponent: () => import('./rapoarte') }
];
@Component({
selector: 'app-root',
imports: [RouterOutlet],
template: `<h1>Panou magazin</h1><router-outlet />`
})
export class App {}Indiciu
import() întoarce tot modulul; routerul are nevoie de clasa din el.
Reparația
import { Component } from '@angular/core';
import { Routes, RouterOutlet } from '@angular/router';
export const routes: Routes = [
{ path: 'rapoarte', loadComponent: () => import('./rapoarte').then((m) => m.Rapoarte) }
];
@Component({
selector: 'app-root',
imports: [RouterOutlet],
template: `<h1>Panou magazin</h1><router-outlet />`
})
export class App {}De ce merge
import('./rapoarte') întoarce obiectul modulului, de forma { Rapoarte: class ... }. Cum fișierul nu are export implicit, routerul primește chiar acest obiect, vede că nu e o componentă standalone și aruncă NG04014.
Cu .then((m) => m.Rapoarte), promisiunea se rezolvă cu clasa componentei. Routerul o creează în outlet, iar fișierul rămâne încărcat leneș, abia la prima vizită pe /rapoarte.
Alte forme ale mesajului
Error: NG04014: Invalid configuration of route 'admin'. The component must be standalone.NG04014: Invalid configuration of route 'rapoarte'. You are using 'loadComponent' with a module, but it must be used with standalone components. Use 'loadChildren' instead.
Cum o eviți pe viitor
- Scrie mereu forma completă:
loadComponent: () => import('./x').then(m => m.X), sau foloseșteexport defaultîn fișierul componentei. - Testează fiecare rută leneșă dând click pe link: eroarea apare abia la încărcare.
- La migrarea de la NgModule, transformă întâi componenta în standalone, apoi schimbă ruta în
loadComponent.
Întrebări frecvente
Care e diferența dintre loadComponent și loadChildren?
loadComponent încarcă o singură componentă standalone pentru o rută. loadChildren încarcă o listă de rute (un fișier cu export const routes) sau, în proiectele vechi, un NgModule cu rute.
De ce eroarea nu apare la pornire?
Fișierul leneș se descarcă abia când navighezi spre rută. Până atunci routerul nu știe ce va întoarce import(), deci validarea se face la prima navigare.
Erori înrudite
NG04014: Invalid configuration of route 'contact'. One of the following must be provided: component, loadComponent, redirectTo, children or loadChildren O rută are doar path, fără nimic de afișat sau de făcut. Adaugă component (sau loadComponent, redirectTo, children, loadChildren); de multe ori cheia există, dar e scrisă greșit (componet, Component). 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. TypeError: Class constructor AdminGuard cannot be invoked without 'new' Ai pus în canActivate o clasă de guard fără @Injectable, iar routerul a apelat-o ca pe o funcție. Transform-o într-un guard funcțional (CanActivateFn) sau adaugă @Injectable({ providedIn: 'root' }) clasei. Î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.
