偽住所ジェネレーター：有効なテスト用住所を作成する（2026年）

各結果は、国定義、その国の5つの都市フィクスチャの1つ、通りの名前一覧、建物番号、郵便番号パターンから組み立てられます。ジェネレーターは国を選び、その中の都市フィクスチャを選び、現地の順序で通りの行を構築し、パターンから郵便番号を埋めます。配送データベースからサンプリングすることも、実在の私書箱からコピーすることもありません。

これにより2つの保証と2つの非保証が生まれます。保証されるのは、形式がその国の慣習に従うこと、そして同じシードが同じ住所を返すことです。保証されないのは、その番号にその通りが実在すること、そして米国以外の郵便番号が実在の配送エリアに対応することです。米国のZIPについては、郵便番号チェッカー上の40,979行のデータセットに対する別個の存在チェックがあります。米国以外ではチェックは構造的なもののみであり、サイトはそれ以上のことを示唆せずにその旨を明記しています。

住所フォームがテストするのは住所そのものではありません。検証レイヤー、マスキング、長さ制限、国と地域の依存関係、そして行をデータベースに書き込むシリアライザーをテストします。すでに不正な形式のフィクスチャは、それらすべてを隠してしまいます。カナダのフィクスチャが「123 Main St, Toronto, ON 12345」であれば、フォームは実際のカナダの郵便番号が決して一致しないパターンを受け入れ、バグは出荷されてしまいます。

逆の失敗も同じくらいよく起こります。チームが実在しそうだがその国には誤ったフィクスチャを手書きし、それを受け入れるためにバリデータに回避策を追加します。半年後、その回避策は不可欠なものになり、なぜドイツの郵便番号フィールドが文字を許可しているのか誰も覚えていません。公開されているパターンに従う生成データは、ジェネレーター自体が自分の知識について正直である限り、両方向のずれを排除します。

合成住所は本番より下のすべてのレイヤーに属します。パーサーやバリデータの単体テスト、住所行の書き込みと読み取りを行う統合テスト、チェックアウトフォームに入力するエンドツーエンドテスト、実在の顧客に触れずにボリュームを必要とする負荷テスト、マーケティングページ向けのローカライズされたスクリーンショット実行などです。ファジングにも有用です。長さ制限や文字セットの境界にある値を意図的に生成できるからです。

実在の配送地点に依存するものには不適切なツールです。不正チェック、本人確認、BAN回避、アカウント養殖、レビュー操作、配送連携のエンドツーエンドテストには使用しないでください。合成住所には私書箱がないため、実際の配送業者のスキャンを必要とするステップは失敗します。また、生成された身元を使って商品やサービスを取得することは、データがどのように生成されたかに関わらず詐欺です。

ジェネレーターは38か国をカバーしています。各国には5つの都市フィクスチャがあるため、合計190の都市定義があり、各都市は地域コード、郵便番号パターン、現地の通りの慣習を把握しています。カバレッジは、住所フォームが実際に構築される市場に重点を置いています。北米、西ヨーロッパと北ヨーロッパ、そしてより大きなアジア太平洋およびラテンアメリカ市場です。

セット内の2か国には郵便番号がまったくありません。香港とアラブ首長国連邦です。ジェネレーターは両国で番号を捏造せず、フィールドを空のままにします。これが正しい動作です。これらの国で郵便番号を必須とするフォームは壊れており、偽のコードを提供するフィクスチャは、実際のユーザーが遭遇するまで欠陥を隠してしまいます。

ジェネレーターの品質はその国のテーブル次第です。以下のパターンは、米国型の単一テンプレートに平坦化されがちなものです。日本は順序が完全に逆であること、オランダは数字の後に文字が来ること、ブラジルと日本はどちらも構造的ではなく慣習的なハイフンを使うことに注目してください。

郵便番号は文字列として保存する必要があります。ドイツ、フランス、スペイン、イタリア、ポーランドはすべて先頭ゼロのコードを発行しており、整数カラムは01067を黙って1067にしてしまいます。オーストラリアやブラジルのコードにも同じことが当てはまります。スキーマに数値の郵便番号カラムがある場合、ドイツの住所をシードした瞬間にフィクスチャがそれを露呈させます。

呼び出しごとに異なる住所を返すジェネレーターはフィクスチャではなくノイズです。シード付き生成は入力を固定し、出力シーケンスをマシン間および実行間で安定させます。テストではシードを明示的に渡し、生成されたデータセットとともに記録し、シードの変更はレビューが必要なフィクスチャの変更として扱ってください。

実用的なパターンは、1つの親シードからエンティティごとのシードを導出することです。たとえば、シードとレコードインデックスのハッシュです。これによりデータセットは安定したまま、行ごとに異なる値を生成できます。また、失敗を再現可能にします。CIが不正な住所を報告したとき、シードとインデックスだけでその行を正確に再生成できます。シードを時計やランダム呼び出しから導出しないでください。それがフレーキーテストを永久的な謎に変える方法です。

これらは2つの異なる主張であり、混同することがテストスイートがその所有者に嘘をつく最も一般的な方法です。構造チェックは「この文字列はその国のパターンに一致するか」に答えます。存在チェックは「このコードは参照データセットに現れるか」に答えます。このサイトの郵便番号チェッカーはすべての国に対して1つ目を行い、2つ目は米国ZIPのみで、40,979行を参照します。

構造チェックの合格は、フォームが整形式の値を拒否しないことを示します。配送業者がそこに配達できるか、その通りの番地が範囲内か、都市がZIPと一致するかについては何も示しません。それらにはこのサイトが提供しない郵便参照データが必要です。実際に行うチェックに合わせてアサーションを書かないと、テスト名は何年も過大な約束をし続けます。

このサイトは社会保障番号、支払カード番号、IMEIやIMSIの値、Bluetoothアドレス、デバイスのシリアル番号を生成しません。これは欠落した機能ではなく、意図的な境界です。これらの識別子にはチェックサム、割り当てレジストリ、または法的制限があり、もっともらしく見える生成値は明らかに偽の値よりもはるかに危険です。なぜなら、素朴なバリデータを通過し、スクリーンショット、チケット、コミットに紛れ込む可能性があるからです。

同じ境界は連絡先データにも適用されます。生成されるメールアドレスは常に予約済みのexample.testドメインを使用し、実在の私書箱に解決されることは決してありません。生成される電話番号は、米国とカナダのNANP 555-0100から555-0199のブロックに限定され、これはフィクション用に予約された範囲です。ワークフローがカード番号や納税者番号を必要とする場合は、プロセッサや税務当局が公開している公式のテスト値を使用し、ジェネレーターからスクレイピングした値は決して使わないでください。