...
Eroare Angular · Router și navigare

NG04014: Invalid configuration of route 'rapoarte'. The component must be standalone.

Pe scurt

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

Greșit
TypeScript
{ path: 'rapoarte', loadComponent: () => import('./rapoarte') }
Corect
TypeScript
{ 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ă

Greșit
TypeScript
// rapoarte.ts
export class Rapoarte {}
// rute
loadComponent: () => import('./rapoarte')
Corect
TypeScript
// 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

Greșit
TypeScript
@Component({ standalone: false, ... })
export class Rapoarte {}
// loadComponent: () => import('./rapoarte').then(m => m.Rapoarte)
Corect
TypeScript
@Component({ selector: 'app-rapoarte', template: '...' })
export class Rapoarte {}

loadComponent acceptă doar componente standalone (implicit din Angular 19). Pentru module se folosește loadChildren.

Repară tu

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șă.

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

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ște export 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

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