CompilerError: Stack too deep. Try compiling with `--via-ir` (cli) or the equivalent `viaIR: true` (standard JSON) while enabling the optimizer. Otherwise, try removing local variables.
Funcția are prea multe variabile vii în același timp (parametri, valori întoarse și variabile locale). EVM poate accesa doar primele 16 poziții din stivă. Scoate variabilele locale intermediare, împarte funcția în funcții mai mici, grupează datele într-un struct sau compilează cu viaIR și optimizer.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
EVM lucrează cu o stivă, iar instrucțiunile DUP și SWAP pot ajunge doar până la a 16-a poziție de sus. Compilatorul clasic ține pe stivă fiecare parametru, fiecare valoare întoarsă și fiecare variabilă locală. Când o funcție are, de exemplu, 8 parametri, 5 valori întoarse și 6 variabile locale, iar la final citește un parametru de la început, acel parametru e prea adânc, iar compilarea se oprește cu Stack too deep.
Eroarea nu ține de logica ta, ci de forma funcției. Soluțiile, de la cea mai simplă:
- elimină variabilele locale intermediare (scrie calculul direct în variabila întoarsă);
- grupează parametrii sau rezultatele într-un
struct; - mută calcule în funcții
internalseparate; - pune variabilele în blocuri
{ ... }, ca să dispară din stivă după folosire; - compilează cu
viaIR: trueși optimizer-ul pornit (pipeline-ul nou mută automat variabile în memorie, dar compilarea e mai lentă).
De ce apare: cauzele frecvente
1Prea multe variabile intermediare
uint256 linie1 = pret1 * cant1;
uint256 linie2 = pret2 * cant2;
uint256 linie3 = pret3 * cant3;
subtotal = linie1 + linie2 + linie3;subtotal = pret1 * cant1 + pret2 * cant2 + pret3 * cant3;Fiecare variabilă locală ocupă o poziție pe stivă; calculul direct nu ocupă niciuna după ce s-a terminat.
2Mulți parametri de același fel
function adauga(string memory nume, uint256 pret, uint256 stoc, uint256 categorie, address furnizor, uint256 tva, uint256 garantie) externalstruct Produs { string nume; uint256 pret; uint256 stoc; uint256 categorie; address furnizor; uint256 tva; uint256 garantie; }
function adauga(Produs calldata p) externalUn struct calldata ocupă o singură poziție pe stivă (adresa lui).
3Activarea pipeline-ului IR în Hardhat
solidity: "0.8.30"solidity: {
version: "0.8.30",
settings: { viaIR: true, optimizer: { enabled: true, runs: 200 } }
}Compilatorul IR poate muta variabilele în memorie. Rezolvă eroarea fără să schimbi codul, dar compilează mai încet.
Repară eroarea, direct în pagină
Contractul Factura calculează o factură cu trei produse, dar compilarea dă CompilerError: Stack too deep. Păstrează semnătura funcției, dar scoate variabilele locale intermediare (linie1…reducere3) și scrie calculele direct în valorile întoarse. Scriptul calculează o factură: 2 × 100, 4 × 50, 5 × 20, reducere 10%, TVA 19%.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Factura {
function calculeaza(uint256 pret1, uint256 cant1, uint256 pret2, uint256 cant2, uint256 pret3, uint256 cant3, uint256 reducereProcent, uint256 tvaProcent)
external pure returns (uint256 articole, uint256 subtotal, uint256 reducere, uint256 tva, uint256 total)
{
uint256 linie1 = pret1 * cant1;
uint256 linie2 = pret2 * cant2;
uint256 linie3 = pret3 * cant3;
uint256 reducere1 = linie1 * reducereProcent / 100;
uint256 reducere2 = linie2 * reducereProcent / 100;
uint256 reducere3 = linie3 * reducereProcent / 100;
subtotal = linie1 + linie2 + linie3;
reducere = reducere1 + reducere2 + reducere3;
tva = (subtotal - reducere) * tvaProcent / 100;
total = subtotal - reducere + tva;
articole = cant1 + cant2 + cant3;
}
}Articole: 11 | subtotal: 500 | reducere: 50 | TVA: 85 | total: 535
Indiciu
Subtotalul e pret1 * cant1 + pret2 * cant2 + pret3 * cant3, iar reducerea se poate calcula o singură dată, din subtotal.
Reparația
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Factura {
function calculeaza(uint256 pret1, uint256 cant1, uint256 pret2, uint256 cant2, uint256 pret3, uint256 cant3, uint256 reducereProcent, uint256 tvaProcent)
external pure returns (uint256 articole, uint256 subtotal, uint256 reducere, uint256 tva, uint256 total)
{
articole = cant1 + cant2 + cant3;
subtotal = pret1 * cant1 + pret2 * cant2 + pret3 * cant3;
reducere = subtotal * reducereProcent / 100;
tva = (subtotal - reducere) * tvaProcent / 100;
total = subtotal - reducere + tva;
}
}De ce merge
Funcția avea 8 parametri, 5 valori întoarse și 6 variabile locale. La final, citirea lui cant1 cerea o poziție mai adâncă de 16 în stivă, peste ce poate accesa EVM. Fără variabilele intermediare, stiva rămâne mică: subtotalul (500) se calculează direct, reducerea de 10% se aplică o singură dată (50), TVA-ul de 19% din 450 este 85 (rotunjit în jos), iar totalul este 535.
Alte forme ale mesajului
CompilerError: Compiler error (/solidity/libsolidity/codegen/LValue.cpp:54): Stack too deep. Try compiling with `--via-ir` (cli) or the equivalent `viaIR: true` (standard JSON) while enabling the optimizer. Otherwise, try removing local variables.CompilerError: Stack too deep, try removing local variables.CompilerError: Stack too deep when compiling inline assembly: Variable headStart is 1 slot(s) too deep inside the stack.
Cum o eviți pe viitor
- Ține funcțiile mici: o funcție cu peste 8–10 parametri și valori întoarse e greu de citit și de apelat.
- Grupează datele care merg împreună într-un
struct. - Evită variabilele locale folosite o singură dată.
- Pentru proiecte mari, activează
viaIRși optimizer-ul de la început, ca să nu schimbi pipeline-ul în ultimul moment.
Întrebări frecvente
De ce limita e 16?
Pentru că EVM are instrucțiuni DUP1–DUP16 și SWAP1–SWAP16: o variabilă de pe stivă poate fi copiată sau mutată doar dacă e între primele 16 poziții. Limita face parte din EVM, nu din Solidity.
Pornesc viaIR și gata?
De multe ori, da, dar compilarea devine mai lentă și bytecode-ul e diferit, deci trebuie retestat. În cursul nostru, compilatorul are setări fixe (fără viaIR), așa că eroarea se rezolvă prin cod.
Erori înrudite
TypeError: Data location must be "memory" or "calldata" for parameter in function, but none was given. Un parametru de tip string, bytes, array sau struct trebuie să spună unde stau datele. Adaugă memory sau calldata după tip: string memory nume (sau string calldata nume în funcțiile external, unde e mai ieftin). Warning: Unused local variable. Ai declarat o variabilă locală pe care nu o folosești nicăieri. Fie e un rest de cod care trebuie șters, fie (mai des) ai calculat ceva și ai uitat să folosești rezultatul. Folosește variabila sau șterge-o. Transaction ran out of gas Tranzacția a consumat tot gas-ul pe care l-a primit (gasLimit) înainte să se termine, de obicei din cauza unei bucle care scrie de multe ori în storage sau a unei limite de gas setate prea mic. Fă funcția să lucreze în pași constanți (fără bucle care cresc cu datele) sau mărește gasLimit-ul. Învață Solidity de la zero, cu exerciții la fiecare lecție
Curs Solidity și Smart Contracts: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
