java.lang.IllegalStateException: This mutex is not locked
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
mutex.lock()
try {
sold -= 10
mutex.unlock()
} finally {
mutex.unlock()
}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
try {
mutex.lock()
actualizeaza()
} finally {
mutex.unlock()
}mutex.lock()
try {
actualizeaza()
} finally {
mutex.unlock()
}Dacă lock() e anulat, nu se ajunge în finally cu un mutex neblocat.
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.
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")
}Sold final: 70
Indiciu
Scoate unlock() din blocul try; finally îl face oricum.
Reparația
import kotlinx.coroutines.sync.*
val mutex = Mutex()
var sold = 100
fun retrage(suma: Int) {
if (mutex.tryLock()) {
try {
sold -= suma
} finally {
mutex.unlock()
}
}
}
fun main() {
repeat(3) { retrage(10) }
println("Sold final: $sold")
}De ce merge
Funcția făcea unlock() în try și încă o dată în finally. Al doilea unlock() găsea mutex-ul deja deblocat și arunca excepția. Cu deblocarea doar în finally, fiecare tryLock() reușit are exact un unlock(), chiar dacă apare o excepție între ele, iar cele trei retrageri de câte 10 dau 70. În corutine, mutex.withLock { } face același lucru automat.
Alte forme ale mesajului
Exception in thread "main" java.lang.IllegalStateException: This mutex is not lockedjava.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
Exception in thread "main" java.util.ConcurrentModificationException Ai modificat o listă sau un map (remove, add) în timp ce îl parcurgeai cu for. Iteratorul observă schimbarea și se oprește. Folosește removeAll { } / removeIf { }, filter { } pentru o listă nouă, sau un iterator explicit cu iterator.remove(). kotlinx.coroutines.JobCancellationException: DeferredCoroutine was cancelled Ai așteptat (await, join) rezultatul unei corutine care fusese anulată, de tine sau de părintele ei. O corutină anulată nu mai are rezultat, așa că await aruncă excepția. Verifică isCancelled înainte, nu anula ce urmează să folosești, sau tratează CancellationException explicit. Suspend function 'suspend fun delay(timeMillis: Long): Unit' can only be called from a coroutine or another suspend function Apelezi o funcție suspend (delay, o funcție proprie marcată suspend) dintr-o funcție obișnuită. Funcțiile suspend pot fi apelate doar din corutine sau din alte funcții suspend. Marchează și funcția apelantă cu suspend, sau pornește o corutină, de exemplu cu runBlocking { } în main. Î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.
