...
Eroare Solidity · Nume nedeclarate și membri inexistenți

Warning: This declaration shadows an existing declaration.

Pe scurt

Ai declarat o variabilă locală sau un parametru cu același nume ca o variabilă de stare (sau ca altă declarație). În funcție, numele se referă la cea locală, așa că variabila de stare nu se mai modifică. Redenumește variabila locală sau scoate tipul din fața ei, dacă voiai să scrii în cea de stare.

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

Ce înseamnă

„Shadowing” înseamnă că o declarație nouă ascunde una mai veche cu același nume. Dacă în contract ai uint256 public total; și în funcție scrii uint256 total = ...;, din acel moment total înseamnă variabila locală, care dispare la finalul funcției. Variabila de stare rămâne neschimbată.

E doar un avertisment, codul se compilează, dar aproape mereu indică un bug: ai vrut să scrii total += suma; și din obișnuință ai pus tipul în față. Apare la fel când un parametru are numele unei variabile de stare (function seteaza(uint256 pret) într-un contract cu pret) sau al unei funcții moștenite (owner, name).

Linia din avertisment e declarația care ascunde; compilatorul îți arată și unde e declarația ascunsă.

De ce apare: cauzele frecvente

1Tip pus din greșeală în fața unei atribuiri

Greșit
SOLIDITY
uint256 public total;

function adauga(uint256 suma) external {
    uint256 total = total + suma;
}
Corect
SOLIDITY
uint256 public total;

function adauga(uint256 suma) external {
    total = total + suma;
}

Cu uint256 în față, linia creează o variabilă locală nouă; fără el, scrie în variabila de stare.

2Parametru cu numele variabilei de stare

Greșit
SOLIDITY
uint256 public pret;

function seteazaPret(uint256 pret) external {
    pret = pret;
}
Corect
SOLIDITY
uint256 public pret;

function seteazaPret(uint256 pretNou) external {
    pret = pretNou;
}

Cu același nume, pret = pret atribuie parametrul lui însuși. Convenția des folosită este _pret sau pretNou.

Repară tu

Repară eroarea, direct în pagină

Contractul Casa adună încasările în total, dar după două încasări de 10 și 5 lei totalul rămâne 0, iar compilatorul arată Warning: This declaration shadows an existing declaration. Repară funcția incaseaza, ca să modifice variabila de stare. Scriptul face cele două încasări și afișează totalul.

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

contract Casa {
    uint256 public total;

    function incaseaza(uint256 suma) external {
        uint256 total = total + suma;
    }
}
După reparație, programul afișează
Total: 15 lei
Indiciu

Linia din funcție declară o variabilă nouă din cauza tipului pus în față.

Cum o eviți pe viitor

  • Nu da variabilelor locale și parametrilor numele variabilelor de stare; folosește un prefix (_pret) sau un alt nume (pretNou).
  • Nu ignora avertismentele: o consolă fără avertismente îți arată imediat unul nou.
  • Scrie uint256 x = ... doar când vrei o variabilă nouă; pentru o variabilă existentă scrie doar x = ....
  • Testează efectul funcției asupra stării, nu doar faptul că nu dă eroare.

Întrebări frecvente

De ce e doar avertisment, dacă e aproape mereu un bug?

Pentru că, tehnic, codul e valid: uneori chiar vrei o variabilă locală cu același nume. Compilatorul te atenționează, dar decizia îți aparține. Tratează-l ca pe o eroare.

Primesc avertismentul pentru un parametru numit owner. De ce?

Pentru că un contract moștenit (de exemplu Ownable) are deja o funcție owner(). Redenumește parametrul, de exemplu initialOwner sau _owner.

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.