...
Eroare Go · Goroutine și canale

fatal error: sync: unlock of unlocked mutex

Pe scurt

Ai apelat Unlock pe un mutex care nu era blocat, de obicei pentru că ai deblocat de două ori (un defer mu.Unlock() plus un mu.Unlock() explicit). Păstrează o singură deblocare pentru fiecare Lock, ideal cu defer imediat după Lock.

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

Ce înseamnă

Fiecare mu.Lock() trebuie urmat de exact un mu.Unlock(). Dacă deblochezi un mutex care e deja liber, Go consideră că starea programului e coruptă și îl oprește cu fatal error: sync: unlock of unlocked mutex. Fiind o eroare fatală, nu poate fi prinsă cu recover.

Pentru sync.RWMutex mesajele sunt fatal error: sync: Unlock of unlocked RWMutex și fatal error: sync: RUnlock of unlocked RWMutex (ai deblocat cu RUnlock fără RLock, sau ai amestecat RLock cu Unlock).

Cauzele frecvente: defer mu.Unlock() combinat cu un Unlock explicit pe o ramură (de exemplu înainte de return), Unlock într-o funcție care nu a făcut Lock, sau un mutex copiat (struct transmis prin valoare), astfel că blochezi o copie și deblochezi alta.

De ce apare: cauzele frecvente

1defer plus Unlock explicit

Greșit
GO
mu.Lock()
defer mu.Unlock()
if sold < suma {
	mu.Unlock()
	return errors.New("fonduri insuficiente")
}
Corect
GO
mu.Lock()
defer mu.Unlock()
if sold < suma {
	return errors.New("fonduri insuficiente")
}

defer deblochează deja la ieșirea din funcție, pe orice ramură.

2RUnlock după Lock

Greșit
GO
mu.Lock()
defer mu.RUnlock()
Corect
GO
mu.Lock()
defer mu.Unlock()

Perechile trebuie să se potrivească: Lock/Unlock și RLock/RUnlock.

3Mutex copiat prin receptor valoare

Greșit
GO
func (c Contor) Inc() {
	c.mu.Lock()
	defer c.mu.Unlock()
	c.n++
}
Corect
GO
func (c *Contor) Inc() {
	c.mu.Lock()
	defer c.mu.Unlock()
	c.n++
}

Cu receptor valoare, fiecare apel lucrează pe o copie a mutex-ului. go vet (analizorul copylocks) semnalează asta.

Repară tu

Repară eroarea, direct în pagină

Metoda Retrage deblochează mutex-ul și cu defer, și explicit pe ramura de eroare, iar programul se oprește cu fatal error: sync: unlock of unlocked mutex. Păstrează o singură deblocare ca programul să afișeze:

Eroare: fonduri insuficiente
Sold: 100
Codul care dă eroarea
GO
package main

import (
	"errors"
	"fmt"
	"sync"
)

type Cont struct {
	mu   sync.Mutex
	sold int
}

func (c *Cont) Retrage(suma int) error {
	c.mu.Lock()
	defer c.mu.Unlock()
	if c.sold < suma {
		c.mu.Unlock()
		return errors.New("fonduri insuficiente")
	}
	c.sold -= suma
	return nil
}

func main() {
	c := &Cont{sold: 100}
	if err := c.Retrage(500); err != nil {
		fmt.Println("Eroare:", err)
	}
	fmt.Println("Sold:", c.sold)
}
După reparație, programul afișează
Eroare: fonduri insuficiente
Sold: 100
Indiciu

defer mu.Unlock() deblochează deja la ieșirea din funcție; scoate Unlock-ul explicit.

Alte forme ale mesajului

  • fatal error: sync: Unlock of unlocked RWMutex
  • fatal error: sync: RUnlock of unlocked RWMutex

Cum o eviți pe viitor

Scrie defer mu.Unlock() pe linia imediat după mu.Lock() și nu mai debloca manual în aceeași funcție. Dacă ai nevoie să deblochezi mai devreme, mută zona protejată într-o funcție separată cu propriul defer. Pune mutex-ul în struct lângă datele pe care le protejează și folosește receptori pointer. Rulează go vet, care prinde mutex-urile copiate.

Întrebări frecvente

De ce nu e doar o panică pe care o pot prinde?

Pentru că un mutex deblocat greșit înseamnă că altă goroutină ar putea fi deja în zona protejată. Go preferă să oprească totul decât să continue cu date posibil corupte.

Pot debloca dintr-o altă goroutină decât cea care a blocat?

Da, sync.Mutex nu e legat de goroutină. Dar e greu de urmărit; în aproape toate cazurile e mai clar ca aceeași funcție să facă Lock și Unlock.

Erori înrudite

← Toate erorile Go

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ță Go de la zero, cu exerciții la fiecare lecție

Curs Go: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.