[ERROR] bundle initial exceeded maximum budget. Budget 1.00 MB was not met by 312.45 kB with a total of 1.31 MB.
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
import { Rapoarte } from './rapoarte';
{ path: 'rapoarte', component: Rapoarte }{ 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ă
import * as _ from 'lodash';import sortBy from 'lodash-es/sortBy';
// sau o funcție proprie, de câteva rânduriImporturile țintite permit eliminarea codului nefolosit (tree shaking).
3Componentă grea afișată mai jos în pagină
<app-grafic-vanzari />@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ă 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”.
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.
Reparația
import { Component } from '@angular/core';
import { Routes, RouterOutlet, RouterLink } from '@angular/router';
@Component({ selector: 'app-acasa', template: `<h2>Bine ai venit!</h2>` })
export class Acasa {}
export const routes: Routes = [
{ path: '', component: Acasa },
{ path: 'rapoarte', loadComponent: () => import('./rapoarte').then((m) => m.Rapoarte) }
];
@Component({
selector: 'app-root',
imports: [RouterOutlet, RouterLink],
template: `<a id="l-rapoarte" routerLink="/rapoarte">Rapoarte</a><router-outlet />`
})
export class App {}De ce merge
Un import { Rapoarte } from './rapoarte' la începutul fișierului de rute pune pagina în bundle-ul inițial, descărcat de fiecare vizitator, chiar dacă nu deschide niciodată rapoartele. Când astfel de pagini se adună, bundle-ul trece de buget.
loadComponent: () => import('./rapoarte')... folosește importul dinamic: la build, pagina devine un fișier separat, descărcat abia la navigarea spre /rapoarte. Utilizatorul vede aceeași pagină, dar pornirea aplicației e mai ușoară.
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
@deferpentru 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.jsondoar 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
[ERROR] Could not resolve "lodash" Builder-ul Angular (esbuild) nu găsește pachetul importat: nu e instalat, numele e greșit sau importul are o cale relativă greșită. Rulează npm install <pachet> (sau npm install după clonare), corectează calea, ori înlocuiește biblioteca cu cod propriu. TS2307: Cannot find module '@angular/material/button' or its corresponding type declarations. Importezi dintr-un pachet care nu e instalat în proiect (aici Angular Material). Instalează-l cu ng add @angular/material (sau npm install), verifică numele importului, sau renunță la el dacă nu ai nevoie. Schema validation failed with the following errors: Data path "" must NOT have additional properties(browserTarget). angular.json conține o opțiune pe care builder-ul folosit nu o mai acceptă (aici browserTarget, redenumită buildTarget). Redenumește sau șterge opțiunea din paranteză, sau rulează ng update, care face migrările automat. Î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.
