JSON Diffでの型変更の検出

型変更は、JSONフィールドが同じキーを保持しているが、値のデータ型がバージョン間で変更される場合に発生します。例としては、文字列が数値になる、スカラーがオブジェクトになる、ブール値がnullになるなどがあります。型変更はスキーマの進化、バグ、または意図的なリファクタリングを示すことが多いため重要です。

一般的な型変更シナリオ:

// 変更前
{
  "count": "42",
  "active": 1,
  "metadata": "none",
  "tags": "javascript"
}

// 変更後
{
  "count": 42,
  "active": true,
  "metadata": null,
  "tags": ["javascript", "typescript"]
}

このdiffには4つの型変更が含まれています：

• count：文字列 "42" から数値 42
• active：数値 1 からブール値 true
• metadata：文字列 "none" から null
• tags：文字列 "javascript" から配列 ["javascript", "typescript"]

型変更が重要な理由:

1. パースの失敗: 厳密に型付けされた言語（Go、Rust、厳密なパース設定のTypeScript）は、予期しない型に遭遇するとエラーをスローします。
2. 比較のバグ: JavaScriptの緩い等価演算子（==）は "42" == 42 を true として扱い、型変更を隠蔽します。厳密等価演算子（===）はそれを検出します。
3. データベーススキーマ: データベースのカラム型の変更（例：VARCHARからINTEGER）にはマイグレーションが必要です。JSON diffはこれらの変更を本番環境に適用する前にプレビューできます。

diffツールの型変更報告方法:

ほとんどのJSON diffツールは型変更を「置換」操作として報告し、古い値と新しい値を表示します。高度なツールは、コードレビュー時に変更をより目立たせるために、型の遷移（例：string -> number）を追加でフラグ付けします。

ベストプラクティス:

• 値が意味的に等しくても、すべての型変更を手動レビュー対象としてフラグ付けしてください。
• APIの境界で意図しない型変更を検出するために、JSON Schemaバリデーションを使用してください。
• 意図的な型変更はAPIの変更ログやマイグレーションガイドに文書化してください。