...
Eroare Solidity · Panic: overflow, împărțire la zero, index greșit

VM Exception while processing transaction: reverted with panic code 0x32 (Array accessed at an out-of-bounds or negative index)

Pe scurt

Ai citit sau scris un element de array la un index care nu există: indexul e egal cu length sau mai mare (de exemplu i <= v.length într-o buclă) ori array-ul e gol. Indicii merg de la 0 la length - 1, deci bucla corectă este for (i = 0; i < v.length; i++).

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

Ce înseamnă

Un array cu 3 elemente are indicii 0, 1 și 2. Accesul la v[3] (sau la orice index mai mare) nu întoarce o valoare goală, ca în JavaScript, ci oprește execuția cu Panic(0x32). Același lucru se întâmplă la v[0] pe un array gol și la scrierea într-un array memory de lungime fixă dincolo de capăt.

Cele mai frecvente cauze: bucla cu <= în loc de < (off-by-one), citirea „ultimului element” cu v[v.length] în loc de v[v.length - 1], un index primit de la utilizator fără verificare și un array memory creat cu new uint256[](n) cu n prea mic.

Atenție: getter-ul automat al unui array public (v(5)) se comportă puțin diferit, dă revert fără motiv, nu Panic, dar cauza e aceeași.

De ce apare: cauzele frecvente

1Buclă cu <= în loc de <

Greșit
SOLIDITY
for (uint256 i = 0; i <= scoruri.length; i++) {
    total += scoruri[i];
}
Corect
SOLIDITY
for (uint256 i = 0; i < scoruri.length; i++) {
    total += scoruri[i];
}

Ultimul index valid este length - 1. Cu <=, ultimul pas citește scoruri[length], care nu există.

2Ultimul element citit cu indexul greșit

Greșit
SOLIDITY
return comenzi[comenzi.length];
Corect
SOLIDITY
require(comenzi.length > 0, "Nicio comanda");
return comenzi[comenzi.length - 1];

Ultimul element e la length - 1, iar pentru un array gol nu există deloc (și length - 1 ar da Panic 0x11).

3Index primit de la utilizator fără verificare

Greșit
SOLIDITY
function produs(uint256 id) external view returns (string memory) {
    return produse[id];
}
Corect
SOLIDITY
function produs(uint256 id) external view returns (string memory) {
    require(id < produse.length, "Produs inexistent");
    return produse[id];
}

Cu verificarea, utilizatorul primește un mesaj clar în loc de Panic.

Repară tu

Repară eroarea, direct în pagină

Contractul Clasament adună scorurile salvate într-un array. Scriptul adaugă scorurile 40, 25 și 35 și cere totalul, dar primește Panic(0x32), acces în afara array-ului. Repară condiția buclei din total, ca să parcurgă exact elementele existente. Scriptul afișează totalul.

Codul care dă eroarea
SOLIDITY
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

contract Clasament {
    uint256[] public scoruri;

    function adauga(uint256 scor) external {
        scoruri.push(scor);
    }

    function total() external view returns (uint256 suma) {
        for (uint256 i = 0; i <= scoruri.length; i++) {
            suma += scoruri[i];
        }
    }
}
După reparație, programul afișează
Total: 100
Indiciu

Ultimul index valid este scoruri.length - 1.

Alte forme ale mesajului

  • execution reverted: Panic due to ARRAY_RANGE_ERROR(50)
  • panic: array out-of-bounds access (0x32)

Cum o eviți pe viitor

  • Scrie buclele mereu cu i < v.length.
  • Verifică indecșii primiți din afară: require(id < v.length, "...").
  • Pentru date căutate după ID, un mapping e adesea mai potrivit decât un array.
  • Testează cu array gol, cu un element și cu ultimul index.

Întrebări frecvente

Ce înseamnă „negative index” în mesaj, dacă indexul e uint?

Indexul nu poate fi negativ în Solidity; textul vine din descrierea generală a codului 0x32. În practică, înseamnă doar index mai mare sau egal cu length.

De ce pop() pe un array gol dă alt cod?

pop() pe un array gol are propriul cod, Panic(0x31). Ambele semnalează că ai lucrat cu un element care nu există; verifică length > 0 înainte.

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.