...
Eroare PostgreSQL · Tranzacții, blocări și concurență

ERROR: cannot execute UPDATE in a read-only transaction

Pe scurt

Tranzacția sau sesiunea este doar pentru citire (READ ONLY), iar tu încerci să modifici date. Apare pe replici (hot standby), cu default_transaction_read_only = on sau în tranzacții deschise cu BEGIN READ ONLY. Trimite scrierile la serverul primar sau deschide o tranzacție READ WRITE.

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

Ce înseamnă

Mesajul numește comanda refuzată (UPDATE, INSERT, CREATE TABLE, nextval()) și apare în trei situații. Prima: tranzacția a fost deschisă explicit BEGIN READ ONLY sau SET TRANSACTION READ ONLY, de exemplu pentru rapoarte. A doua: setarea default_transaction_read_only este activă pe sesiune, rol sau bază de date, de obicei intenționat, pentru utilizatori de raportare. A treia, cea mai frecventă în producție: conexiunea a ajuns pe o replică (hot standby), unde orice scriere e imposibilă.

Pe replici, mesajul poate fi și cannot execute UPDATE during recovery. Soluția este rutarea corectă: scrierile merg pe primar (de exemplu cu target_session_attrs=read-write în șirul de conexiune), iar citirile pot merge pe replici. Verifică starea cu SHOW transaction_read_only și SELECT pg_is_in_recovery().

De ce apare: cauzele frecvente

1Tranzacție de raport refolosită pentru scriere

Greșit
SQL
BEGIN READ ONLY;
UPDATE produse SET stoc = 0 WHERE id = 4;
Corect
SQL
BEGIN;  -- implicit READ WRITE
UPDATE produse SET stoc = 0 WHERE id = 4;
COMMIT;

Tranzacțiile care scriu nu trebuie deschise ca doar citire.

2Conexiune pe replică

Greșit
SQL
jdbc:postgresql://replica:5432/magazin
Corect
SQL
jdbc:postgresql://primar:5432,replica:5432/magazin?targetServerType=primary

Driverul alege serverul care acceptă scrieri.

Repară tu

Repară eroarea, direct în pagină

Scriptul de mentenanță marchează monitorul ca epuizat, dar a fost copiat dintr-un raport și deschide tranzacția cu BEGIN READ ONLY, deci dă cannot execute UPDATE in a read-only transaction. Deschide o tranzacție obișnuită, confirmă și afișează stocul monitorului.

Codul care dă eroarea
SQL
BEGIN READ ONLY;
UPDATE produse SET stoc = 0 WHERE id = 4;
COMMIT;
SELECT stoc FROM produse WHERE id = 4;
După reparație, programul afișează
BEGIN
UPDATE 1
COMMIT
 stoc
------
    0
(1 rând)
Indiciu

BEGIN fără READ ONLY

Alte forme ale mesajului

  • ERROR: cannot execute INSERT in a read-only transaction
  • ERROR: cannot execute UPDATE during recovery

Cum o eviți pe viitor

  • Separă clar conexiunile de citire (replici) de cele de scriere (primar).
  • Folosește BEGIN READ ONLY doar pentru rapoarte, nu pentru fluxuri mixte.
  • Configurează driverul cu atributul de sesiune potrivit (target_session_attrs, targetServerType).
  • Verifică pg_is_in_recovery() când apar erori de scriere neașteptate.

Întrebări frecvente

De ce ar folosi cineva tranzacții READ ONLY?

Pentru siguranță în rapoarte și pentru SERIALIZABLE READ ONLY DEFERRABLE, care rulează fără risc de erori de serializare.

nextval e considerat scriere?

Da. Secvențele nu pot avansa într-o tranzacție doar pentru citire sau pe replică.

Erori înrudite

← Toate erorile PostgreSQL

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

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