...
Eroare Solidity · Moștenire, override și contracte abstracte

TypeError: Trying to override non-virtual function. Did you forget to add "virtual"?

Pe scurt

Încerci să suprascrii o funcție din contractul părinte care nu e marcată virtual. Adaugă virtual la funcția din părinte (dacă e codul tău) sau, dacă e o bibliotecă precum OpenZeppelin, suprascrie funcția internă prevăzută pentru asta, de exemplu _update.

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

Ce înseamnă

În Solidity, o funcție poate fi suprascrisă doar dacă autorul contractului părinte a permis-o explicit, cu virtual. Mesajul spune că funcția din copil are override, dar cea din părinte nu e virtual, deci nu are voie să fie înlocuită.

Linia din eroare este a funcției din părinte (cea fără virtual), iar compilatorul îți arată și unde e suprascrierea.

Dacă părintele e codul tău, adaugi virtual. Dacă părintele vine dintr-o bibliotecă (OpenZeppelin, de exemplu), nu modifici biblioteca: alegi punctul de extensie prevăzut. În OpenZeppelin 5, toate mișcările de tokeni (transfer, mint, burn) trec prin funcția virtual _update, iar _transfer nu e virtuală tocmai ca să suprascrii _update.

De ce apare: cauzele frecvente

1Ai uitat virtual în părinte

Greșit
SOLIDITY
contract Forma {
    function nume() public pure returns (string memory) { return "forma"; }
}
contract Cerc is Forma {
    function nume() public pure override returns (string memory) { return "cerc"; }
}
Corect
SOLIDITY
contract Forma {
    function nume() public pure virtual returns (string memory) { return "forma"; }
}
contract Cerc is Forma {
    function nume() public pure override returns (string memory) { return "cerc"; }
}

virtual din părinte permite suprascrierea, iar override din copil o confirmă.

2Vrei să schimbi o funcție internă non-virtuală din OpenZeppelin

Greșit
SOLIDITY
function _transfer(address from, address to, uint256 value) internal override {
    // taxă la transfer
}
Corect
SOLIDITY
function _update(address from, address to, uint256 value) internal override {
    // taxă la transfer, apoi:
    super._update(from, to, value);
}

În OpenZeppelin 5, _transfer nu e virtual; punctul de extensie pentru toate mișcările de tokeni este _update.

Repară tu

Repară eroarea, direct în pagină

Contractele Notificare și NotificareSms nu se compilează și dau TypeError: Trying to override non-virtual function. Did you forget to add "virtual"? NotificareSms vrea să schimbe textul canalului, dar funcția din părinte nu permite asta. Repară părintele, fără să scoți override din copil. Scriptul afișează canalul fiecărui contract.

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

contract Notificare {
    function canal() public pure returns (string memory) {
        return "email";
    }
}

contract NotificareSms is Notificare {
    function canal() public pure override returns (string memory) {
        return "sms";
    }
}
După reparație, programul afișează
Notificare: email
NotificareSms: sms
Indiciu

Funcția din părinte trebuie să spună că poate fi suprascrisă.

Cum o eviți pe viitor

  • Când scrii un contract de bază, marchează virtual funcțiile pe care copiii trebuie să le poată schimba.
  • Nu modifica fișierele bibliotecilor; caută în documentație funcțiile virtual gândite ca puncte de extensie.
  • După ce suprascrii, apelează super.functie(...) dacă vrei să păstrezi și comportamentul original.

Întrebări frecvente

De ce nu sunt toate funcțiile virtual automat?

Pentru siguranță: autorul unui contract decide ce comportament poate fi schimbat. Așa, un contract copil nu poate înlocui din greșeală o verificare importantă din părinte.

Pot suprascrie o variabilă de stare?

Nu. Doar funcțiile se suprascriu. O variabilă public poate însă suprascrie o funcție external virtuală din părinte (getter-ul ei o implementează).

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.