...
Eroare Kotlin · Corutine

java.lang.IllegalStateException: This mutex is not locked

Pe scurt

Ai apelat unlock() pe un Mutex care nu era blocat: unlock fără lock, unlock de două ori sau unlock într-un finally la care lock-ul n-a reușit. Folosește mutex.withLock { ... }, care blochează și deblochează automat, exact o dată.

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

Ce înseamnă

Mutex din kotlinx.coroutines protejează o zonă de cod, ca o singură corutină să o execute la un moment dat: lock() (care suspendă până primești accesul), codul, apoi unlock(). Fiecare unlock() trebuie să corespundă unui lock() reușit.

Dacă deblochezi un mutex care nu e blocat, unlock() aruncă IllegalStateException: This mutex is not locked. Cauze tipice: unlock() apelat de două ori (o dată în cod, o dată în finally), lock() pus în try (dacă e anulat, finally face unlock fără lock) sau ramuri if care deblochează fără să fi blocat.

Dacă folosești un proprietar (lock(owner)), mesajul poate fi și This mutex is locked by ..., but ... is expected.

De ce apare: cauzele frecvente

1unlock de două ori

Greșit
KOTLIN
mutex.lock()
try {
    sold -= 10
    mutex.unlock()
} finally {
    mutex.unlock()
}
Corect
KOTLIN
mutex.withLock {
    sold -= 10
}

withLock face lock, rulează blocul și face unlock o singură dată, chiar și la excepție.

2lock pus în interiorul try

Greșit
KOTLIN
try {
    mutex.lock()
    actualizeaza()
} finally {
    mutex.unlock()
}
Corect
KOTLIN
mutex.lock()
try {
    actualizeaza()
} finally {
    mutex.unlock()
}

Dacă lock() e anulat, nu se ajunge în finally cu un mutex neblocat.

Repară tu

Repară eroarea, direct în pagină

Funcția de mai jos retrage bani dintr-un sold protejat de un Mutex (cu tryLock, fără corutine), dar deblochează mutex-ul de două ori și programul se oprește cu java.lang.IllegalStateException: This mutex is not locked. Repară funcția ca mutex-ul să fie deblocat o singură dată, în finally, iar programul să afișeze Sold final: 70.

Codul care dă eroarea
KOTLIN
import kotlinx.coroutines.sync.*

val mutex = Mutex()
var sold = 100

fun retrage(suma: Int) {
    if (mutex.tryLock()) {
        try {
            sold -= suma
            mutex.unlock()
        } finally {
            mutex.unlock()
        }
    }
}

fun main() {
    repeat(3) { retrage(10) }
    println("Sold final: $sold")
}
După reparație, programul afișează
Sold final: 70
Indiciu

Scoate unlock() din blocul try; finally îl face oricum.

Alte forme ale mesajului

  • Exception in thread "main" java.lang.IllegalStateException: This mutex is not locked
  • java.lang.IllegalStateException: This mutex is not locked

Cum o eviți pe viitor

Folosește aproape mereu mutex.withLock { } în loc de lock/unlock manual. Ține zona protejată cât mai mică (doar citirea și scrierea stării comune). Pentru contoare simple, ia în calcul AtomicInteger sau MutableStateFlow.update { }, care nu au nevoie de mutex.

Întrebări frecvente

Pot folosi synchronized în corutine?

Nu în jurul unui cod care suspendă: synchronized blochează firul, iar o corutină poate continua pe alt fir după suspendare. Mutex e varianta potrivită pentru corutine.

Mutex-ul e reentrant?

Nu. Dacă aceeași corutină face lock() de două ori fără unlock(), rămâne blocată pentru totdeauna (deadlock).

Erori înrudite

← Toate erorile Kotlin

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

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