...
Eroare Solidity · Funcții: locația datelor, vizibilitate, view și pure

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.

Pe scurt

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 internal separate;
  • 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

Greșit
SOLIDITY
uint256 linie1 = pret1 * cant1;
uint256 linie2 = pret2 * cant2;
uint256 linie3 = pret3 * cant3;
subtotal = linie1 + linie2 + linie3;
Corect
SOLIDITY
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

Greșit
SOLIDITY
function adauga(string memory nume, uint256 pret, uint256 stoc, uint256 categorie, address furnizor, uint256 tva, uint256 garantie) external
Corect
SOLIDITY
struct Produs { string nume; uint256 pret; uint256 stoc; uint256 categorie; address furnizor; uint256 tva; uint256 garantie; }
function adauga(Produs calldata p) external

Un struct calldata ocupă o singură poziție pe stivă (adresa lui).

3Activarea pipeline-ului IR în Hardhat

Greșit
SOLIDITY
solidity: "0.8.30"
Corect
SOLIDITY
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ă tu

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

Codul care dă eroarea
SOLIDITY
// 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;
    }
}
După reparație, programul afișează
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.

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

← Toate erorile Solidity

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