Fake-Adressgenerator: Gültige Testadressen erstellen (2026)

Jedes Ergebnis wird aus einer Länderdefinition, einer von fünf Stadt-Fixtures dieses Landes, einer Straßennamenliste, einer Hausnummer und einem Postleitzahlenmuster zusammengesetzt. Der Generator wählt ein Land, wählt darin ein Stadt-Fixture, baut eine Straßenzeile in der lokalen Reihenfolge und füllt die Postleitzahl aus dem Muster. Nichts wird aus einer Lieferdatenbank entnommen, und nichts wird von einem echten Briefkasten kopiert.

Das ergibt zwei Garantien und zwei Nicht-Garantien. Garantiert: Das Format folgt den Konventionen des Landes, und derselbe Seed liefert dieselbe Adresse. Nicht garantiert: dass die Straße unter dieser Nummer existiert oder dass eine nicht-US-Postleitzahl zu einem realen Zustellgebiet gehört. Für US-ZIPs gibt es eine separate Existenzprüfung gegen einen Datensatz mit 40.979 Zeilen im Postleitzahlen-Checker. Außerhalb der Vereinigten Staaten ist die Prüfung rein strukturell, und die Seite sagt das auch, statt mehr zu suggerieren.

Adressformulare testen selten die Adresse. Sie testen die Validierungsschicht, die Maskierung, die Längenbegrenzungen, die Abhängigkeit von Land zu Region und den Serializer, der die Zeile in die Datenbank schreibt. Ein Fixture, das bereits fehlerhaft ist, verdeckt all das. Wenn Ihr kanadisches Fixture „123 Main St, Toronto, ON 12345“ lautet, akzeptiert das Formular ein Muster, das eine echte kanadische Postleitzahl niemals erfüllen kann, und der Bug geht in Produktion.

Der umgekehrte Fehler ist ebenso häufig. Teams schreiben von Hand ein Fixture, das echt aussieht, aber für das Land falsch ist, und bauen dann einen Workaround in den Validator ein, damit er es akzeptiert. Ein halbes Jahr später ist der Workaround tragend, und niemand erinnert sich, warum das deutsche Postleitzahlenfeld Buchstaben erlaubt. Generierte Daten, die den veröffentlichten Mustern folgen, beseitigen beide Arten der Drift – solange der Generator selbst ehrlich darüber ist, was er weiß.

Synthetische Adressen gehören in jede Schicht unterhalb der Produktion: Unit-Tests für Parser und Validatoren, Integrationstests, die Adresszeilen schreiben und lesen, End-to-End-Tests, die ein Checkout-Formular ausfüllen, Lasttests, die Volumen brauchen, ohne einen echten Kunden zu berühren, und lokalisierte Screenshot-Läufe für eine Marketingseite. Sie sind auch für Fuzzing nützlich, weil man gezielt Werte an der Grenze eines Längenlimits oder eines Zeichensatzes erzeugen kann.

Sie sind das falsche Werkzeug für alles, was von einem realen Zustellpunkt abhängt. Verwenden Sie sie nicht für Betrugsprüfungen, Identitätsverifizierung, Sperrumgehung, Account-Farming, Bewertungsmanipulation oder das End-to-End-Testen einer Versandintegration. Eine synthetische Adresse hat keinen Briefkasten, daher wird jeder Schritt scheitern, der einen tatsächlichen Carrier-Scan erfordert, und die Verwendung generierter Identitäten, um Waren oder Dienstleistungen zu erlangen, ist Betrug – unabhängig davon, wie die Daten erzeugt wurden.

Der Generator deckt 38 Länder ab. Jedes Land enthält fünf Stadt-Fixtures, insgesamt also 190 Stadtdefinitionen, und jede Stadt kennt ihren Regionscode, ihr Postleitzahlenmuster und die lokalen Straßenkonventionen. Der Schwerpunkt liegt auf Märkten, in denen Adressformulare tatsächlich gebaut werden: Nordamerika, West- und Nordeuropa sowie die größeren Märkte im asiatisch-pazifischen Raum und in Lateinamerika.

Zwei Länder im Set haben überhaupt keine Postleitzahl: Hongkong und die Vereinigten Arabischen Emirate. Der Generator lässt das Feld für beide leer, statt eine Nummer zu erfinden. Das ist das korrekte Verhalten. Ein Formular, das die Postleitzahl in diesen Ländern als Pflichtfeld markiert, ist fehlerhaft, und ein Fixture, das einen Fake-Code liefert, verdeckt den Defekt, bis ein echter Nutzer darauf stößt.

Ein Generator ist nur so gut wie seine Ländertabelle. Die folgenden Muster sind diejenigen, die am häufigsten in eine einzige US-förmige Vorlage gepresst werden. Beachten Sie, dass Japan die Reihenfolge vollständig umkehrt, dass die Niederlande Buchstaben nach die Ziffern setzen und dass Brasilien und Japan beide einen Bindestrich verwenden, der konventionell und nicht strukturell bedingt ist.

Postleitzahlen müssen als Strings gespeichert werden. Deutschland, Frankreich, Spanien, Italien und Polen vergeben allesamt Codes mit führenden Nullen, und eine Integer-Spalte macht aus 01067 stillschweigend 1067. Dasselbe gilt für australische und brasilianische Codes. Wenn Ihr Schema eine numerische Postleitzahlenspalte hat, wird das Fixture sie in dem Moment aufdecken, in dem Sie eine deutsche Adresse seeden.

Ein Generator, der bei jedem Aufruf eine andere Adresse liefert, ist kein Fixture, sondern Rauschen. Geseedete Generierung legt eine Eingabe fest, sodass die Ausgabesequenz über Maschinen und Läufe hinweg stabil bleibt. Übergeben Sie den Seed in Tests explizit, protokollieren Sie ihn mit jedem generierten Datensatz und behandeln Sie eine Änderung des Seeds als Änderung des Fixtures, die überprüft werden muss.

Das praktische Muster besteht darin, pro Entität Seeds aus einem übergeordneten Seed abzuleiten, zum Beispiel einen Hash aus Seed und Datensatzindex. Das hält den Datensatz stabil und erzeugt trotzdem unterschiedliche Werte pro Zeile. Es macht Fehler außerdem reproduzierbar: Wenn CI eine fehlerhafte Adresse meldet, reichen Seed plus Index, um genau diese Zeile erneut zu erzeugen. Leiten Sie den Seed niemals aus der Uhr oder aus einem Zufallsaufruf ab, denn so wird aus einem flaky Test ein dauerhaftes Rätsel.

Das sind zwei verschiedene Aussagen, und sie zu vermischen ist der häufigste Weg, auf dem eine Testsuite ihre Eigentümer belügt. Eine strukturelle Prüfung beantwortet die Frage „Entspricht dieser String dem Muster des Landes?“. Eine Existenzprüfung beantwortet die Frage „Kommt dieser Code in einem Referenzdatensatz vor?“. Der Postleitzahlen-Checker auf dieser Seite erledigt das Erste für jedes Land und das Zweite nur für US-ZIPs, wo er 40.979 Zeilen konsultiert.

Ein struktureller Durchlauf sagt Ihnen, dass das Formular einen wohlgeformten Wert nicht ablehnen wird. Er sagt Ihnen nichts darüber, ob ein Carrier dorthin zustellen kann, ob die Hausnummer für diese Straße im gültigen Bereich liegt oder ob die Stadt zur Postleitzahl passt. Dafür braucht es Postreferenzdaten, die diese Seite nicht mitliefert. Formulieren Sie Ihre Assertions passend zu der Prüfung, die Sie tatsächlich durchführen, sonst versprechen die Testnamen jahrelang zu viel.

Die Seite erzeugt keine Sozialversicherungsnummern, Zahlungskartennummern, IMEI- oder IMSI-Werte, Bluetooth-Adressen oder Geräteseriennummern. Das ist eine bewusste Grenze, kein fehlendes Feature. Diese Identifikatoren tragen Prüfsummen, Vergaberegister oder rechtliche Beschränkungen, und ein plausibel aussehender generierter Wert ist weit gefährlicher als ein offensichtlich falscher, weil er einen naiven Validator bestehen und in einem Screenshot, einem Ticket oder einem Commit landen kann.

Dieselbe Grenze gilt für Kontaktdaten. Generierte E-Mail-Adressen verwenden immer die reservierte Domain example.test, die niemals zu einem echten Postfach auflösen kann. Generierte Telefonnummern sind auf den NANP-Block 555-0100 bis 555-0199 in den USA und Kanada beschränkt, den für fiktive Nutzung reservierten Bereich. Wenn ein Workflow eine Kartennummer oder eine Steuer-ID benötigt, verwenden Sie die offiziellen Testwerte, die der Prozessor oder die Steuerbehörde veröffentlicht, und niemals einen aus einem Generator gescrapten Wert.