大規模な .NET 11 コードベースで Newtonsoft.Json 13 から System.Text.Json へ移行する
Newtonsoft.Json 13.0.4 を .NET 11 組み込みの System.Text.Json に置き換えるための、バージョン固定の手引きです。属性とオプションの対応付け、出力フォーマットを静かに変えてしまうデフォルト値、段階的な展開戦略、検証、そして大規模コードベースを襲う落とし穴を扱います。
タグ: system-text-json
9 件
System.Text.Json vs Newtonsoft.Json（2026年）: どちらを選ぶべきか？
.NET 11 の新規コードには System.Text.Json を選びましょう。ランタイムに同梱され、約2倍高速で、Native AOT で動作する唯一の選択肢です。Newtonsoft.Json は JSONPath、TypeNameHandling、本当に緩い JSON のためだけに使います。
Fix: A possible object cycle was detected
System.Text.Json は逆参照を持つグラフのシリアライズを拒否します。ReferenceHandler.IgnoreCycles を設定するか、DTO に射影するか、逆向きポインタに [JsonIgnore] を付けてください。Preserve は最終手段です。
修正: System.Text.Json.JsonException: The JSON value could not be converted
System.Text.Json は、受信した JSON トークンが対象の CLR 型と一致しない場合にこの例外をスローします。JSON を型に合わせるか、両者を橋渡しする JsonConverter または JsonSerializerOption を登録してください。
Fix: The JSON value could not be converted to System.DateTime
System.Text.Json は DateTime に ISO 8601 文字列のみ受け付けます。2026-05-08T14:00:00Z を送るか、JsonConverter を登録してフォーマットをパースしてください。空文字や Unix タイムスタンプも例外を投げます。
.NET 11 Preview 4 で VSTest が Newtonsoft.Json を切り離す、推移的依存に頼っていた場合に壊れる場所
.NET 11 Preview 4 と Visual Studio 18.8 が出荷する VSTest は、もう Newtonsoft.Json をテストプロジェクトに流し込みません。推移的なコピーをこっそり使っていたビルドは壊れ、PackageReference を一行足すだけで直ります。
System.Text.Json でカスタム JsonConverter を書く方法
.NET 11 における System.Text.Json 用のカスタム JsonConverter<T> の完全ガイドです。本当に必要となる場面、Utf8JsonReader を正しく進める方法、JsonConverterFactory によるジェネリクスの扱い、そして AOT に優しい実装方法までを解説します。
.NET 11 Preview 3 の System.Text.Json が PascalCase とメンバー単位のネーミングポリシーを追加
.NET 11 Preview 3 は System.Text.Json のネーミングポリシーの話を完成させます: JsonNamingPolicy.PascalCase、メンバーレベルの [JsonNamingPolicy] 属性、そしてクリーンな DTO のための型レベルの [JsonIgnore] デフォルト。
C# 14 のアイデア: インターセプターで System.Text.Json のソース生成を自動的に感じられるようにできる
コミュニティの議論で、C# 14 のインターセプターを使って JsonSerializer の呼び出しを書き換え、生成された JsonSerializerContext を自動で利用させる案が提案されました。AOT に優しいソース生成を保ちつつ、呼び出し側をきれいに保ちます。