Warning: Unnamed return variable can remain unassigned. Add an explicit return with value to all non-reverting code paths or name the variable.
Există un drum prin funcție (de obicei ultimul caz dintr-un if) care se termină fără return. Pe acel drum funcția întoarce valoarea implicită (0, false, text gol), fără nicio eroare. Adaugă un return și pentru ultimul caz, sau un revert dacă acel caz e invalid.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Spre deosebire de alte limbaje, în Solidity o funcție cu returns (...) care ajunge la final fără return nu dă eroare: întoarce valoarea implicită a tipului (0, false, "", address(0)). Compilatorul observă când există un astfel de drum și te avertizează.
Cazul tipic este un șir de if-uri care acoperă doar o parte din valori: if (varsta < 18) return "minor"; if (varsta < 65) return "adult";, iar pentru 70 funcția întoarce un text gol. Bug-ul e greu de observat, pentru că apelul reușește.
Rezolvarea depinde de intenție: dacă ultimul caz e valid, pune un return final; dacă nu trebuie să se întâmple niciodată, pune revert(...), ca apelul să eșueze vizibil. Dacă ai dat nume valorii întoarse (returns (string memory categorie)), avertismentul dispare, dar răspunderea de a o seta rămâne a ta.
De ce apare: cauzele frecvente
1Lipsește ultimul caz
if (varsta < 18) return "minor";
if (varsta < 65) return "adult";if (varsta < 18) return "minor";
if (varsta < 65) return "adult";
return "senior";Ultimul return acoperă toate valorile rămase.
2Caz invalid tratat în tăcere
function pretPentru(uint8 tip) external pure returns (uint256) {
if (tip == 1) return 10;
if (tip == 2) return 25;
}function pretPentru(uint8 tip) external pure returns (uint256) {
if (tip == 1) return 10;
if (tip == 2) return 25;
revert("Tip necunoscut");
}Fără revert, un tip greșit ar avea prețul 0, adică produs gratuit.
Repară eroarea, direct în pagină
Contractul Bilete încadrează clienții după vârstă. Compilarea arată Warning: Unnamed return variable can remain unassigned., iar pentru 70 de ani funcția întoarce un text gol. Adaugă cazul lipsă: toți cei de 65 de ani sau mai mult sunt senior. Scriptul afișează categoria pentru 10, 30 și 70 de ani.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Bilete {
function categorie(uint256 varsta) external pure returns (string memory) {
if (varsta < 18) {
return "minor";
}
if (varsta < 65) {
return "adult";
}
}
}10 ani: "minor" 30 ani: "adult" 70 ani: "senior"
Indiciu
Pune un return final, după cele două if-uri.
Reparația
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Bilete {
function categorie(uint256 varsta) external pure returns (string memory) {
if (varsta < 18) {
return "minor";
}
if (varsta < 65) {
return "adult";
}
return "senior";
}
}De ce merge
Pentru 70 de ani niciun if nu se potrivea, iar funcția ajungea la final fără return, deci întorcea valoarea implicită a unui string, textul gol. Solidity nu dă eroare în acest caz, doar avertismentul. Cu return "senior"; la final, fiecare drum prin funcție întoarce o valoare.
Cum o eviți pe viitor
- Termină fiecare funcție cu
returnscu unreturnsau unrevertfinal. - Pentru valori necunoscute, preferă
revert: o eroare vizibilă e mai bună decât un 0 tăcut. - Testează și cazurile de la margine (ultimul interval, valori neprevăzute).
- Tratează avertismentele ca pe niște erori: ele semnalează exact astfel de bug-uri.
Întrebări frecvente
De ce nu e eroare, ci doar avertisment?
Pentru că valorile întoarse au mereu o valoare implicită, deci codul e valid. Uneori chiar vrei 0 sau false pe drumul rămas, dar atunci e mai clar să scrii explicit return 0;.
Dispare avertismentul dacă dau nume valorii întoarse?
Da, pentru că atunci compilatorul presupune că o setezi tu. Bug-ul nu dispare însă: dacă uiți s-o setezi pe un drum, primești tot valoarea implicită.
Erori înrudite
TypeError: Different number of arguments in return statement than in returns declaration. return întoarce alt număr de valori decât ai declarat în returns(...). Dacă funcția declară două valori, scrie return (a, b); dacă declară una, întoarce una. Dacă funcția nu are returns, scoate valoarea din return. Warning: Unreachable code. Ai cod după un return, un revert sau o buclă din care nu se iese: el nu se execută niciodată. De obicei e o instrucțiune importantă pusă în ordinea greșită (resetarea unei valori, un emit). Mut-o înainte de return. VM Exception while processing transaction: reverted with reason string 'Plata insuficienta' Un require (sau revert) din contract a oprit tranzacția, iar textul dintre ghilimele este chiar mesajul scris în cod. Caută mesajul în contract, vezi ce condiție verifică și află de ce n-a fost îndeplinită: argumente greșite, alt cont, prea puțin ether sau o condiție scrisă greșit. Î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.
