Diese Serie hat mit der Grundidee angefangen, dass WordPress und LinkedIn zusammengehören sollten. Ein Jahr und einige Bugs später — Zeit, das mal in konkrete Ratschläge für andere zu übersetzen, die selbst ein WordPress-Plugin mit externer API-Anbindung bauen wollen.
**Locking von Anfang an einbauen.** Der Doppelpost-Bug war im Kern ein fehlendes Lock um die Job-Queue. Das im Nachhinein einzubauen ist unnötiger Aufwand — plant es von Anfang an ein, sobald irgendein Cronjob mit einer externen API spricht.
**Strukturiertes Logging für jeden API-Fehler.** Ohne saubere Logs hätten wir weder den OAuth-Bug noch die API-Scope-Probleme so schnell gefunden. Investiert hier früh Zeit, auch wenn’s sich zunächst wie unnötiger Zusatzaufwand anfühlt.
**Scopes zuerst prüfen.** Bei API-Fehlern liegt die Ursache überraschend oft nicht im eigenen Code, sondern in den angeforderten Berechtigungen. Das als ersten Reflex zu etablieren spart enorm viel Debugging-Zeit.
**Gegen echte, unordentliche Umgebungen testen.** Die eigene, saubere Testumgebung mit zwei aktiven Plugins ist nicht repräsentativ. Echte WordPress-Installationen sind chaotischer, und genau dort brechen Dinge, die vorher nie ein Problem waren.
**Das eigene Tool täglich selbst benutzen.** Der wichtigste Punkt, der sich durch diese ganze Serie zieht: Die relevantesten Bugs — Doppelpost, OAuth-Redirect — sind uns nicht in einem Test aufgefallen, sondern im echten, eigenen, täglichen Gebrauch.
Keiner dieser fünf Punkte ist im Nachhinein überraschend. Aber ehrlich gesagt hab ich jeden einzelnen erst nach einem konkreten Vorfall wirklich verinnerlicht — nicht vorher, aus reiner Theorie. Vielleicht hilft’s dem ein oder anderen, sich zumindest einen der Vorfälle zu sparen.
Schreibe einen Kommentar