Seite 42 - Mironsoft Blog

GraphQL kennt kein HTTP-Äquivalent für fachliche Fehler. Wer Fachfehler als Resolver-Exceptions modelliert, Transportfehler nicht vom Netzwerkproblem unterscheidet und extensions.category ignoriert, baut ein Fehlerhandling, das das Frontend zwingt, auf Heuristiken statt auf Struktur zu reagieren.

Validierungsfehler, die als rohe HTML-Seite oder als unstrukturiertes JSON-Array ankommen, kosten Frontend-Teams Zeit. RFC 7807 Problem Details definieren ein maschinenlesbares Format, das Symfony mit wenig Aufwand aus der ConstraintViolationList erzeugt – konsistent, dokumentierbar und ohne Framework-Lock-in.

Die Wahl der richtigen Dokumentations-UI für eine REST API ist keine Kleinigkeit – sie beeinflusst, wie schnell sich externe Entwickler in die API einarbeiten, ob Consumer-Teams API-Endpunkte direkt ausprobieren können, und wie viel Aufwand die Integration in die CI-Pipeline kostet. Swagger UI, Redoc, Scalar und Stoplight Elements haben unterschiedliche Stärken und Philosophien.

Multipart-Uploads in GraphQL sind technisch möglich, bringen aber in der Praxis mehr Probleme als sie lösen. Wer Dateien über GraphQL hochlädt, kämpft mit Proxies, Body-Size-Limits, fehlendem Caching und schwer testbaren Resolvern. Dieser Artikel erklärt, wo die echten Grenzen liegen und wie Presigned URLs das eleganter lösen.

Formular-Elemente sind die am schwersten zu stylenden HTML-Elemente. Browser-Defaults, plattformspezifische Appearance und fehlende Utility-Angriffspunkte machen Checkboxen, Select-Dropdowns und Custom Inputs zu einer ständigen Herausforderung. Das @tailwindcss/forms Plugin löst das systematisch.

API Reviews ohne systematische Checkliste übersehen konsistent dieselben Kategorien: Security-Aspekte, Fehlerformate, Performance und Testabdeckung werden im Zeitdruck gerne übersprungen. Eine strukturierte Checkliste macht Reviews schneller, vollständiger und wiederholbar – und stellt sicher, dass kein PR mit einer kritischen Lücke gemergt wird.

Common Table Expressions strukturieren komplexe SQL-Abfragen in benannte, wiederverwendbare Schritte — lesbarer als verschachtelte Subqueries, mächtiger als Views für Einmalabfragen.