【解決】System.Text.Json 9.0.0.0 で FileNotFoundException｜System.Threading.Tasks.Extensions が必要な理由と対処法【.NET Framework】

✅ 概要

.NET Framework で System.Text.Json を使っていて、次のようなエラーに遭遇していませんか？

JsonSerializer.Serialize("") // ← 実行時

例外がスローされました: 'System.IO.FileNotFoundException' (〇〇.exe の中)
ファイルまたはアセンブリ 'System.Threading.Tasks.Extensions, Version=4.2.0.1, Culture=neutral, PublicKeyToken='、またはその依存関係の 1 つが読み込めませんでした。指定されたファイルが見つかりません。

System.Text.Json 9.0 以降で発生する実行時エラーの原因と対処法は下記です

🔍 エラー内容と原因

エラー内容（例）

System.IO.FileNotFoundException
Message=ファイルまたはアセンブリ 'System.Threading.Tasks.Extensions, Version=4.2.0.1' が見つかりません。
Source=System.Text.Json

原因

.NET Framework 上で System.Text.Json, Version=9.0.0.0 以降を使用すると、内部で System.Threading.Tasks.Extensions を参照しているようです

⚠️ よくある誤解

誤解	実際
Visual Studio でビルド通ったから大丈夫？	❌ 実行時にDLLがなければクラッシュします。
System.Text.Json だけ入れればOK？	❌ 依存DLL（特に `System.Threading.Tasks.Extensions`）も必要です。

✅ 解決方法：必要なDLLをプロジェクトに追加する

1. プロジェクト内の「参照の追加」から System.Threading.Tasks.Extensionsの追加

Visual Studio プロジェクト内の「参照の追加」から System.Threading.Tasks.Extensionsの追加が必要です

2. DLLがビルドフォルダにコピーされているか確認

ビルド後に、以下のファイルが bin\Debug\ または bin\Release\ に存在する確認：

System.Threading.Tasks.Extensions.dll

✅ 依存関係まとめ

System.Text.Json を使う場合、以下の依存DLLが必要になることがあります：

System.Threading.Tasks.Extensions ✅（必須）
System.Buffers
System.Memory
System.Runtime.CompilerServices.Unsafe
System.Numerics.Vectors（使っていなければ不要）

🔚 まとめ

項目	内容
エラー原因	System.Text.Json v9.0+ が `System.Threading.Tasks.Extensions` を要求
対処法	NuGetで明示的にインストールし、DLLが出力されることを確認
OS依存性	Windows 11 にも DLL は含まれていない。必ず配布対象に含める