...
Eroare Angular · Angular CLI, build și configurare

[ERROR] bundle initial exceeded maximum budget. Budget 1.00 MB was not met by 312.45 kB with a total of 1.31 MB.

Pe scurt

Codul încărcat la pornirea aplicației (bundle-ul inițial) a depășit limita din budgets în angular.json, iar ng build se oprește. Încarcă paginile grele leneș (loadComponent, @defer), scoate bibliotecile mari neutilizate sau, dacă e justificat, mărește limita.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Budgets sunt limite de dimensiune definite în angular.json, în configurația production. ng build măsoară fișierele generate și le compară cu limitele: depășirea pragului maximumWarning dă un avertisment, depășirea pragului maximumError dă această eroare și build-ul eșuează.

Mesajul se citește așa: bundle initial este tot JavaScript-ul și CSS-ul încărcat la prima deschidere a aplicației; Budget 1.00 MB este limita; was not met by 312.45 kB este cât ai depășit; with a total of 1.31 MB este dimensiunea reală.

Bundle-ul inițial crește când importi direct (nu leneș) pagini mari, biblioteci grele (grafice, editoare, utilitare întregi) sau stiluri globale mari. Limita există ca să observi creșterea înainte să ajungă la utilizatori pe telefoane și conexiuni lente.

De ce apare: cauzele frecvente

1Pagini importate direct în rute

Greșit
TypeScript
import { Rapoarte } from './rapoarte';
{ path: 'rapoarte', component: Rapoarte }
Corect
TypeScript
{ path: 'rapoarte', loadComponent: () => import('./rapoarte').then((m) => m.Rapoarte) }

Cu loadComponent, pagina și dependențele ei ajung într-un fișier separat, descărcat doar la nevoie.

2Bibliotecă mare importată întreagă

Greșit
TypeScript
import * as _ from 'lodash';
Corect
TypeScript
import sortBy from 'lodash-es/sortBy';
// sau o funcție proprie, de câteva rânduri

Importurile țintite permit eliminarea codului nefolosit (tree shaking).

3Componentă grea afișată mai jos în pagină

Greșit
TypeScript
<app-grafic-vanzari />
Corect
TypeScript
@defer (on viewport) {
  <app-grafic-vanzari />
} @placeholder {
  <p>Graficul se încarcă...</p>
}

@defer mută componenta și dependențele ei într-un fișier încărcat abia când devine vizibilă.

Repară tu

Repară eroarea, direct în pagină

La ng build, bundle-ul inițial depășește bugetul, pentru că pagina de rapoarte (din rapoarte.ts) e importată direct în rute. Încarc-o leneș cu loadComponent, fără importul static, astfel încât după click pe #l-rapoarte să apară tot „Rapoarte de vânzări”.

Codul care dă eroarea
TypeScript
import { Component } from '@angular/core';
import { Routes, RouterOutlet, RouterLink } from '@angular/router';
import { Rapoarte } from './rapoarte';

@Component({ selector: 'app-acasa', template: `<h2>Bine ai venit!</h2>` })
export class Acasa {}

export const routes: Routes = [
  { path: '', component: Acasa },
  { path: 'rapoarte', component: Rapoarte }
];

@Component({
  selector: 'app-root',
  imports: [RouterOutlet, RouterLink],
  template: `<a id="l-rapoarte" routerLink="/rapoarte">Rapoarte</a><router-outlet />`
})
export class App {}
Indiciu

loadComponent primește o funcție care face import() dinamic.

Alte forme ale mesajului

  • [WARNING] bundle initial exceeded maximum budget. Budget 500.00 kB was not met by 245.80 kB with a total of 745.80 kB.
  • Error: bundle initial exceeded maximum budget. Budget 1.00 MB was not met by 312.45 kB with a total of 1.31 MB.
  • [WARNING] src/app/rapoarte/rapoarte.css exceeded maximum budget. Budget 4.00 kB was not met by 1.20 kB with a total of 5.20 kB.

Cum o eviți pe viitor

  • Încarcă leneș fiecare secțiune mare a aplicației (loadComponent, loadChildren).
  • Folosește @defer pentru componente grele care nu sunt vizibile imediat.
  • Analizează bundle-ul (ng build --stats-json și un analizor) când crește brusc.
  • Mărește limitele din angular.json doar după ce ai verificat că dimensiunea e justificată.

Întrebări frecvente

Pot pur și simplu să măresc limita?

Poți, în angular.json, la budgets (maximumWarning / maximumError). E o decizie legitimă dacă aplicația chiar are nevoie de cod în plus, dar întâi verifică ce a crescut: de multe ori e o bibliotecă importată greșit.

De ce ng serve merge, iar ng build nu?

Bugetele sunt verificate în configurația production, folosită implicit de ng build. Serverul de dezvoltare nu le verifică.

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.