...
Eroare System Design · Cache: stampede, date vechi, memorie plină

READONLY You can't write against a read only replica.

Pe scurt

Aplicația trimite scrieri unui nod Redis care e replică: fie a fost configurată cu adresa replicii, fie a rămas conectată la fostul master după un failover. Conectează aplicația prin Sentinel, Redis Cluster sau endpoint-ul primar al serviciului gestionat, ca să urmeze automat masterul curent.

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

Ce înseamnă

Replicile Redis sunt read-only implicit (replica-read-only yes). Orice comandă de scriere trimisă către o replică primește READONLY You can't write against a read only replica.

În system design, mesajul apare aproape întotdeauna după un failover. Sentinel (sau serviciul gestionat) a promovat o replică, iar fostul master a revenit ca replică. Aplicația care avea conexiuni deschise spre fostul master, sau care folosește IP-ul lui fix, scrie acum într-o replică. Același lucru se întâmplă când un client vechi ține în cache o adresă DNS.

Soluția e ca aplicația să nu cunoască adrese de noduri, ci să întrebe cine e masterul: clientul Sentinel întreabă Sentinel-ul, clientul cluster urmează redirecționările MOVED, iar serviciile gestionate (ElastiCache, Azure Cache) oferă un endpoint primar care se mută singur. În plus, clientul trebuie să se reconecteze la erori READONLY.

De ce apare: cauzele frecvente

1Adresa fixă a unui nod

Greșit
redis = Redis(host='10.0.1.21', port=6379)   # masterul de la instalare
Corect
from redis.sentinel import Sentinel
sentinel = Sentinel([('s1', 26379), ('s2', 26379), ('s3', 26379)])
redis = sentinel.master_for('magazin', socket_timeout=0.5)

Clientul Sentinel află masterul curent și se reconectează după failover.

2Scrieri trimise la endpoint-ul de citire

Greșit
REDIS_URL=redis://magazin-ro.xxxx.cache.amazonaws.com:6379   # reader endpoint
Corect
REDIS_URL=redis://magazin.xxxx.cache.amazonaws.com:6379      # primary endpoint

Endpoint-ul de citire duce la replici; scrierile trebuie trimise la cel primar.

Repară tu

Repară eroarea, direct în pagină

Răspunde la cele două întrebări despre READONLY You can't write against a read only replica după un failover Redis.

Indiciu

Care nod e master după failover și la care e conectată aplicația?

Alte forme ale mesajului

  • ReplyError: READONLY You can't write against a read only replica.
  • redis.exceptions.ReadOnlyError: You can't write against a read only replica.

Cum o eviți pe viitor

  • Nu folosi IP-uri de noduri; conectează-te prin Sentinel, cluster sau endpoint-ul primar.
  • Configurează clientul să se reconecteze la erori de rol.
  • Testează failover-ul cache-ului cu aplicația pornită.
  • Separă clar endpoint-urile de citire de cele de scriere.

Întrebări frecvente

E periculos să scriu pe o replică dacă dezactivez read-only?

Da: modificările de pe replică se pierd la următoarea sincronizare cu masterul și creează date inconsistente.

De ce eroarea apare doar câteva secunde după failover?

Clienții buni detectează schimbarea și se reconectează la noul master. Clienții cu adresă fixă rămân în eroare până la repornire.

Erori înrudite

← Toate erorile System Design

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

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