Query-String-Array-Parameter: Warum Sprachen sie verschieden lesen

Wenn in einer URL derselbe Schlüssel mehrfach vorkommt, etwa bei ?tag=a&tag=b, hängt es von der Programmiersprache und dem Framework ab, ob daraus ein Array wird oder nur der letzte Wert übrig bleibt. Deshalb kommt es häufig vor, dass der vom Frontend gesendete Query-String im Backend anders interpretiert wird und am Ende nur ein einziger Wert ankommt. In diesem Beitrag erfahren Sie, warum diese Regeln auseinandergehen und wie Sie selbst überprüfen können, wie ein Query-String tatsächlich gelesen wird.
Zusammenfassung ① Der Query-String einer URL kennt von sich aus keinen Datentyp „Array“. Ob mehrere Werte als Array gelten, ist lediglich eine Konvention der jeweiligen Sprache oder des Frameworks. ② Grob gibt es zwei Varianten: den wiederholten Schlüssel (
tag=a&tag=b) und die Schreibweise mit eckigen Klammern (tag[]=a&tag[]=b), bei der nur Schlüssel mit Klammern als Array erkannt werden. ③ Welche Regel gilt, sehen Sie auch ohne Blick in den Code: Wandeln Sie den Query-String einfach in JSON um.
Das Problem
Stellen Sie sich eine Filteransicht vor, in der Sie per Checkbox mehrere Tags auswählen. Der Browser sendet Werte mit gleichem Namen in der Regel wiederholt, also als tag=a&tag=b.
Erkennt der Server, der diese Anfrage erhält, nur die Schreibweise mit eckigen Klammern als Array, sieht die Sache anders aus: Ein wiederholter Schlüssel ohne Klammern wird nicht zu einem Array zusammengefasst, es bleibt nur der letzte Wert übrig.
Umgekehrt gilt: Sie haben anhand der API-Dokumentation die Form tag[]=a&tag[]=b selbst gebaut und gesendet, aber die Gegenseite behandelt nur wiederholte Schlüssel als Array. Dann wird der Schlüssel fälschlich als ein einzelner Schlüssel mit dem Namen „tag[]“ gelesen.
Solche Fehler fallen bei einem Test mit nur einem Wert nicht auf. Sie treten erst auf, wenn derselbe Schlüssel mehrfach vorkommt, etwa bei Mehrfachauswahl oder mehreren Tags. Entsprechend schwer ist die Ursache zu finden.
Die Lösung
Zuerst sollten Sie sich klarmachen: Der Query-String einer URL kennt den Datentyp „Array“ gar nicht. Alles nach dem Fragezeichen ist nur eine Zeichenkette aus key=value-Paaren, die mit & aneinandergereiht sind. Ob daraus ein Array wird, legt die Seite fest, die den String liest – es ist eine Konvention.
Diese Konventionen lassen sich grob in zwei Gruppen einteilen. Entweder wird derselbe Schlüssel einfach wiederholt, oder es werden eckige Klammern angehängt, damit der Schlüssel als Array erkannt wird.
Wiederholter Schlüssel oder eckige Klammern
Die Standard-API des Browsers, URLSearchParams, fasst wiederholte Schlüssel nicht von selbst zu einem Array zusammen. get("tag") liefert nur den ersten Wert. Möchten Sie alle Werte erhalten, müssen Sie ausdrücklich getAll("tag") aufrufen.
Auch eckige Klammern behandelt URLSearchParams nicht gesondert. Wenn Sie tag[]=a&tag[]=b übergeben, wird nicht „tag“, sondern ein Schlüssel mit dem Namen „tag[]“ erkannt.
Sprachen und Frameworks mit der Klammer-Schreibweise verhalten sich dagegen genau umgekehrt. Wird tag=a&tag=b ohne Klammern wiederholt, entsteht kein Array, sondern es bleibt nur der letzte Wert übrig. Für ein Array müssen Sie die Form tag[]=a&tag[]=b verwenden.
Schritt für Schritt von Hand prüfen
Wenn Werte verloren gehen, gehen Sie am besten in dieser Reihenfolge vor. Prüfen Sie zuerst, ob Ihr eigener Code wiederholte Schlüssel oder eckige Klammern sendet.
Vergleichen Sie danach in der Dokumentation des Servers, welche Regel für das Parsen des Query-Strings gilt. Unterscheiden sich beide, müssen Sie entweder das Format im Client anpassen oder im Server Code ergänzen, der wiederholte Schlüssel selbst zu einem Array zusammenfasst.
Am schnellsten gelingt die Prüfung, wenn Sie einen Query-String tatsächlich eingeben und mit eigenen Augen sehen, ob daraus ein Array wird. Probieren Sie es mit unserem Tool „URL-Parser & Query-String-Umwandlung“ aus.
Geben Sie eine URL oder einen Query-String ein, und Sie sehen die als Array gebündelten Parameter sofort als JSON.

Typische Stolperstellen
| Situation | Ursache |
|---|---|
| Mehrere Checkboxen wurden ausgewählt, aber auf dem Server kommt nur ein Wert an | Der Server erkennt nur die Klammer-Schreibweise (tag[]=) als Array, der Client hat aber wiederholte Schlüssel (tag=a&tag=b) gesendet. |
Mit URLSearchParams.get("tag") erhalten Sie nur einen Wert | get() gibt immer nur den ersten Wert zurück. Für alle Werte benötigen Sie getAll("tag"). |
| Ein Array aus JSON wurde in einen Query-String umgewandelt, aber der Server kann ihn nicht lesen | Das Array wurde mit wiederholten Schlüsseln serialisiert, der Server erkennt aber nur die Klammer-Schreibweise als Array. |
| Bei derselben URL ist das Ergebnis anders, sobald Sprache oder Framework wechseln | Für Arrays im Query-String gibt es keinen festen Standard, daher unterscheiden sich die Parsing-Regeln. |
Fazit
Ob ein mehrfach vorkommender Schlüssel im Query-String zu einem Array zusammengefasst wird und welche Schreibweise als Array gilt, ist kein Standard, sondern Konvention der jeweiligen Sprache oder des Frameworks.
Verschwindende Werte oder nur ein einzelner übrig gebliebener Wert entstehen meist, wenn die vom Client gesendete Schreibweise und die vom Server erwartete nicht zusammenpassen. Wenn Sie nicht sicher sind, welche Konvention gilt, wandeln Sie den tatsächlichen Query-String in JSON um und sehen Sie sich das Ergebnis an. Das ist der verlässlichste Weg.
Geben Sie eine URL oder einen Query-String ein, und Sie sehen die als Array gebündelten Parameter sofort als JSON.
Häufige Fragen
Wird tag[]=a&tag[]=b mit eckigen Klammern als Array erkannt?
Das Tool verwendet unverändert die Browser-Standard-API URLSearchParams und interpretiert eckige Klammern deshalb nicht gesondert. Wenn Sie tag[]=a&tag[]=b eingeben, wird nicht „tag“ angezeigt, sondern ein Schlüssel mit dem Namen „tag[]“, der zwei Werte enthält. Bei der Anbindung an ein Backend, das eckige Klammern als Array-Schreibweise nutzt, sollten Sie diesen Unterschied berücksichtigen.
Welches Format entsteht, wenn ich ein Array aus JSON in einen Query-String umwandle?
Der Tab „JSON → Query“ serialisiert Array-Werte nicht mit eckigen Klammern, sondern durch Wiederholung desselben Schlüssels. So wird zum Beispiel {"tag": ["a", "b"]} zu tag=a&tag=b. Benötigt Ihr Server die Klammer-Schreibweise, müssen Sie [] im Ergebnis selbst ergänzen.
Worin unterscheiden sich die Tabs „URL zerlegen“ und „Query → JSON“?
„URL zerlegen“ gliedert die gesamte URL auf, bis hin zu protocol, host, port, pathname und hash, und zeigt den enthaltenen Query-Teil zusätzlich als JSON an. Wenn Sie nur den Query-String nach dem Fragezeichen vorliegen haben, können Sie ihn direkt in den Tab „Query → JSON“ einfügen.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen