READONLY You can't write against a read only replica.
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
redis = Redis(host='10.0.1.21', port=6379) # masterul de la instalarefrom 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
REDIS_URL=redis://magazin-ro.xxxx.cache.amazonaws.com:6379 # reader endpointREDIS_URL=redis://magazin.xxxx.cache.amazonaws.com:6379 # primary endpointEndpoint-ul de citire duce la replici; scrierile trebuie trimise la cel primar.
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?
Reparația
- q1: Aplicația scrie pe un nod care acum e replică.
- q2: client Sentinel / cluster și endpoint-ul primar gestionat.
De ce merge
După failover, rolurile s-au schimbat, dar aplicația a rămas la adresa veche. Un client care întreabă cine e masterul (Sentinel, cluster, endpoint primar) urmează schimbarea automat.
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
Baza primară a căzut și tot site-ul s-a oprit (fără failover) Serverele sunt redundante, dar baza de date are o singură instanță, deci căderea ei oprește toate scrierile și citirile care nu sunt în cache. Adaugă o replică de rezervă cu failover automat (Multi-AZ, Patroni, replica set), ca o copie să preia rolul primarei în câteva zeci de secunde. Split brain: două noduri primare după o partiție de rețea După o întrerupere de rețea între noduri, ambele părți ale clusterului s-au crezut singure și fiecare a promovat un primar care a acceptat scrieri, deci datele au divergent. Previi cu cvorum (majoritate dintr-un număr impar de noduri), fencing pentru fostul primar și tokenuri de epocă. Î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.
