13 November 2026

Wie behebt man eine unterbrochene PostgreSQL-Replikation?

Techniker schließt ein gelöstes Netzwerkkabel in einem schwach beleuchteten Rechenzentrum-Serverrack wieder an.
KI-generiertes Bild

Eine unterbrochene PostgreSQL-Replikation® gehört zu den kritischsten Situationen im Datenbankbetrieb. Sobald ein Standby-Server nicht mehr mit dem Primary synchronisiert ist, wächst der Rückstand, und im schlimmsten Fall ist ein Failover nicht mehr möglich. Dieser Leitfaden zeigt Ihnen Schritt für Schritt, wie Sie eine unterbrochene Replikation diagnostizieren, reparieren und dauerhaft absichern.

Die folgenden Abschnitte führen Sie von der ersten Fehleranalyse bis zur abschließenden Verifikation. Ob Sie die Streaming-Replikation neu starten oder den Standby-Server vollständig neu aufsetzen müssen, hängt von der Ursache ab. Beginnen Sie daher immer mit der Diagnose, bevor Sie Maßnahmen ergreifen.

Ursachen einer unterbrochenen Replikation identifizieren

Bevor Sie mit der Reparatur beginnen, müssen Sie verstehen, warum die PostgreSQL-Replikation unterbrochen wurde. Die häufigsten Ursachen lassen sich in wenige Kategorien einteilen, die unterschiedliche Lösungswege erfordern.

Prüfen Sie zunächst das PostgreSQL-Logfile auf dem Standby-Server. Typische Fehlermeldungen geben bereits einen klaren Hinweis auf die Ursache:

  • WAL-Segment nicht mehr verfügbar: Der Primary hat WAL-Segmente bereits recycelt, bevor der Standby sie lesen konnte. Ursache ist häufig ein zu kleiner wal_keep_size-Wert oder ein fehlend konfigurierter Replication Slot.
  • Verbindungsabbruch: Netzwerkprobleme, Firewall-Regeln oder ein Neustart des Primary-Servers haben die Verbindung unterbrochen.
  • Authentifizierungsfehler: Das Replikations-Passwort ist abgelaufen oder der Eintrag in pg_hba.conf wurde geändert.
  • Replication Slot inaktiv: Ein nicht verwendeter Replication Slot hat WAL-Dateien angehäuft und den Speicher des Primary-Servers erschöpft, woraufhin der Primary die Verbindung abgelehnt hat.
  • Zeitsynchronisation: Starke Uhrzeitabweichungen zwischen Primary und Standby können zu Verbindungsproblemen führen.

Führen Sie auf dem Primary-Server außerdem die folgende Abfrage aus, um den Replikationsstatus zu prüfen:

SELECT * FROM pg_stat_replication;

Erscheint der Standby dort nicht, ist die Verbindung vollständig unterbrochen. Ist er sichtbar, aber sent_lsn und replay_lsn weichen stark voneinander ab, liegt ein Rückstand vor, der sich möglicherweise noch aufholen lässt.

Voraussetzungen und Zugriff vor der Reparatur prüfen

Bevor Sie in die Reparatur einsteigen, stellen Sie sicher, dass alle notwendigen Zugänge und Informationen vorliegen. Eine unvollständige Vorbereitung führt häufig zu Unterbrechungen mitten im Reparaturprozess.

  • SSH-Zugriff auf Primary- und Standby-Server
  • PostgreSQL-Superuser-Zugang (z. B. postgres-Benutzer)
  • Kenntnis der PostgreSQL-Version auf beiden Servern (müssen übereinstimmen)
  • Zugriff auf die Konfigurationsdateien: postgresql.conf, pg_hba.conf, recovery.conf bzw. standby.signal
  • Ausreichend freier Speicherplatz auf dem Standby-Server für ein mögliches Neuaufsetzen
  • Netzwerkverbindung zwischen Primary und Standby verifiziert (z. B. per pg_isready oder telnet)

Notieren Sie außerdem den aktuellen LSN-Wert des Primary mit SELECT pg_current_wal_lsn();. Dieser Wert dient später als Referenz, um zu prüfen, ob der Standby nach der Reparatur tatsächlich aufholt.

Replikation auf dem Standby-Server neu starten

Wenn die Ursache ein temporärer Verbindungsabbruch oder ein Konfigurationsproblem ist und der Standby noch über alle notwendigen WAL-Segmente verfügt, reicht häufig ein Neustart des PostgreSQL-Dienstes auf dem Standby aus, um die Replikation wieder aufzunehmen.

  1. Prüfen Sie auf dem Standby, ob standby.signal (ab PostgreSQL 12) oder recovery.conf (bis PostgreSQL 11) vorhanden und korrekt konfiguriert ist.
  2. Stellen Sie sicher, dass primary_conninfo in der Konfiguration die korrekte Adresse, den Port und die Anmeldedaten des Primary enthält.
  3. Korrigieren Sie ggf. den Eintrag in pg_hba.conf auf dem Primary-Server, sodass der Standby-Host die Berechtigung replication besitzt.
  4. Starten Sie den PostgreSQL-Dienst auf dem Standby neu: systemctl restart postgresql
  5. Beobachten Sie das Logfile auf dem Standby unmittelbar nach dem Neustart: journalctl -u postgresql -f oder die PostgreSQL-Logdatei im Datenverzeichnis.

Nach dem Neustart sollte im Log eine Meldung wie „started streaming WAL from primary“ erscheinen. Führen Sie dann erneut SELECT * FROM pg_stat_replication; auf dem Primary aus. Erscheint der Standby dort mit einem aktiven Status und sinkt der Lag, ist die Replikation erfolgreich wiederhergestellt. Wenn diese Meldung ausbleibt oder Fehler auftreten, ist ein vollständiges Neuaufsetzen des Standby erforderlich.

Standby mit pg_basebackup neu aufsetzen

Fehlen auf dem Standby WAL-Segmente, die der Primary bereits nicht mehr vorhält, ist ein vollständiges Neuaufsetzen des Standby-Servers der einzig zuverlässige Weg. pg_basebackup ist das Standardwerkzeug für diesen Vorgang und gehört zum PostgreSQL-Lieferumfang.

Standby-Datenverzeichnis leeren

Stoppen Sie zunächst den PostgreSQL-Dienst auf dem Standby und sichern Sie das bestehende Datenverzeichnis, falls Sie es später noch benötigen:

  1. systemctl stop postgresql
  2. Sichern oder benennen Sie das Datenverzeichnis um: mv /var/lib/postgresql/data /var/lib/postgresql/data_backup
  3. Erstellen Sie ein leeres Zielverzeichnis: mkdir /var/lib/postgresql/data und stellen Sie sicher, dass der postgres-Benutzer Eigentümer ist.

Basisbackup vom Primary übertragen

Führen Sie pg_basebackup als postgres-Benutzer auf dem Standby-Server aus:

  1. pg_basebackup -h <primary-ip> -U replicator -D /var/lib/postgresql/data -P -Xs -R
  2. Der Parameter -Xs überträgt WAL-Segmente per Streaming während des Backups. -R erstellt automatisch die Datei standby.signal und trägt primary_conninfo in die postgresql.auto.conf ein.
  3. Warten Sie, bis der Vorgang abgeschlossen ist. Bei großen Datenbanken kann dies je nach Netzwerkbandbreite einige Zeit in Anspruch nehmen.

Nach Abschluss des Backups starten Sie den PostgreSQL-Dienst auf dem Standby: systemctl start postgresql. Prüfen Sie das Log auf die Meldung, dass der Standby WAL-Segmente vom Primary streamt. Der Standby befindet sich jetzt in einem konsistenten Ausgangszustand und holt den Rückstand gegenüber dem Primary auf.

Replikationsstatus nach der Reparatur verifizieren

Nach dem Neustart der Replikation sollten Sie systematisch prüfen, ob die Streaming-Replikation in PostgreSQL wie erwartet funktioniert. Eine schnelle Sichtprüfung reicht hier nicht aus.

  1. Führen Sie auf dem Primary aus: SELECT client_addr, state, sent_lsn, write_lsn, flush_lsn, replay_lsn, sync_state FROM pg_stat_replication; und prüfen Sie, ob der Standby mit dem Status streaming erscheint.
  2. Berechnen Sie den Replikations-Lag in Bytes: SELECT pg_wal_lsn_diff(pg_current_wal_lsn(), replay_lsn) AS lag_bytes FROM pg_stat_replication;. Der Wert sollte kontinuierlich sinken und sich Null annähern.
  3. Prüfen Sie auf dem Standby: SELECT pg_is_in_recovery(); muss true zurückgeben.
  4. Testen Sie die Replikation mit einer kleinen Schreiboperation auf dem Primary und prüfen Sie, ob die Änderung auf dem Standby ankommt.

Sobald lag_bytes bei null liegt und der Standby stabil im Status streaming bleibt, ist die Reparatur erfolgreich abgeschlossen. Dokumentieren Sie die durchgeführten Schritte und die identifizierte Ursache, um bei zukünftigen Vorfällen schneller reagieren zu können.

Replikationsunterbrechungen künftig verhindern

Die beste Reparatur ist die, die Sie nie durchführen müssen. Mit einigen gezielten Konfigurationsanpassungen und einem durchdachten Monitoring lassen sich die meisten Replikationsfehler in PostgreSQL von vornherein vermeiden.

  • WAL-Puffer ausreichend dimensionieren: Setzen Sie wal_keep_size auf einen Wert, der dem Standby genug Zeit gibt, WAL-Segmente zu lesen, auch wenn er kurzzeitig zurückfällt. Alternativ bieten Replication Slots eine zuverlässigere Methode, WAL-Segmente zu reservieren.
  • Replication Slots mit Bedacht einsetzen: Slots verhindern das Löschen benötigter WAL-Dateien, können aber bei inaktiven Standbys den Speicher des Primary erschöpfen. Überwachen Sie den Slot-Lag aktiv.
  • Monitoring einrichten: Überwachen Sie pg_stat_replication kontinuierlich und setzen Sie Alarme, sobald der Replikations-Lag einen definierten Schwellenwert überschreitet. Viele Monitoring-Lösungen wie Prometheus mit dem postgres_exporter bieten hierfür fertige Metriken.
  • Netzwerkstabilität sicherstellen: Replikationsverbindungen profitieren von stabilen, latenzarmen Netzwerkverbindungen. Prüfen Sie regelmäßig die Verbindungsqualität zwischen Primary und Standby.
  • Regelmäßige Tests: Testen Sie den Failover-Prozess in einer Nicht-Produktionsumgebung, damit Sie im Ernstfall sicher und schnell handeln können.
  • PostgreSQL aktuell halten: Neuere Minor-Releases beheben häufig Stabilitätsprobleme in der Replikation. Planen Sie regelmäßige Updates ein.

Mit einem soliden Monitoring- und Support-Konzept lassen sich Replikationsprobleme oft erkennen, bevor sie zu einem tatsächlichen Ausfall führen.

Wie credativ® bei PostgreSQL-Replikationsproblemen hilft

Replikationsfehler treten häufig zu ungünstigen Zeitpunkten auf und erfordern tiefes Fachwissen, das intern nicht immer verfügbar ist. Unser PostgreSQL® Kompetenz-Center unterstützt Sie in genau diesen Situationen mit erfahrenen Spezialisten und einem strukturierten Vorgehen.

  • Fehlerdiagnose und Sofortmaßnahmen: Wir analysieren die Ursache einer unterbrochenen Replikation und leiten gezielt die richtigen Reparaturschritte ein, ohne unnötige Ausfallzeit.
  • Neuaufsetzen und Konfigurationsoptimierung: Wir setzen Standby-Server neu auf, optimieren WAL-Konfiguration und Replication Slots und sorgen dafür, dass die Umgebung stabil bleibt.
  • High Availability und Cluster-Konzepte: Wir planen und implementieren robuste HA-Architekturen, die Replikationsunterbrechungen strukturell verhindern.
  • Maßgeschneiderte Monitoring-Umgebungen: Wir richten Alerting und Dashboards ein, die Sie frühzeitig auf Replikations-Lag und andere kritische Metriken hinweisen.
  • 24/7 Support: Unser Open Source Support Center ist rund um die Uhr erreichbar, ohne Callcenter und mit direktem Zugang zu PostgreSQL-Spezialisten.

Wenn Sie Unterstützung bei einer laufenden Replikationsstörung benötigen oder Ihre PostgreSQL-Umgebung langfristig absichern möchten, kontaktieren Sie uns direkt. Wir helfen Ihnen schnell und unkompliziert weiter.

PostgreSQL® ist eine Marke der PostgreSQL Global Development Group. credativ® ist Competence Center für PostgreSQL®. Die Nennung dient ausschließlich der sachlichen Beschreibung von Dienstleistungen von credativ®. Es besteht keine geschäftliche Verbindung zu den genannten Markeninhabern über die genannte Beziehung hinaus.

Ähnliche Artikel

Kategorien: credativ® Inside

über den Autor

Peter Dreuw

Head of Sales & Marketing

zur Person

Peter Dreuw arbeitet seit 2016 für die credativ GmbH und ist seit 2017 Teamleiter. Seit 2021 ist er Teil des Management-Teams als VP Services der Instaclustr. Mit der Übernahme durch die NetApp wurde seine neue Rolle "Senior Manager Open Source Professional Services". Im Rahmen der Ausgründung wurde er Mitglied der Geschäftsleitung als Prokurist. Sein Aufgabenfeld ist die Leitung des Vertriebs und des Marketings. Er ist Linux-Nutzer der ersten Stunden und betreibt Linux-Systeme seit Kernel 0.97. Trotz umfangreicher Erfahrung im operativen Bereich ist er leidenschaftlicher Softwareentwickler und kennt sich auch mit hardwarenahen Systemen gut aus.

Beiträge ansehen


Beitrag teilen: