System.Text.Json отключаем сериализацию на основе рефлексии

Начиная с .NET 8, значение false у JsonSerializerIsReflectionEnabledByDefault отключает стандартный переход к рефлексии в System.Text.Json. После этого метаданные сериализации нужно предоставить через контекст, созданный генератором исходного кода.

Исправление — 2 ноября 2026 года: Ранее была указана неверная ошибка и создавалось впечатление, что достаточно передать объект настроек. При отключённой стандартной рефлексии обычный вызов сериализации выдаёт InvalidOperationException; пустые настройки проблему не решают.

Отключение стандартной рефлексии

Добавьте это свойство в .csproj:

<PropertyGroup>
  <JsonSerializerIsReflectionEnabledByDefault>false</JsonSerializerIsReflectionEnabledByDefault>
</PropertyGroup>

При такой настройке и JsonSerializer.Serialize(widget), и JsonSerializer.Serialize(widget, new JsonSerializerOptions()) завершаются ошибкой. Создание объекта настроек не предоставляет метаданные типа. Свойство JsonSerializer.IsReflectionEnabledByDefault показывает действующее значение переключателя.

Переключатель управляет стандартным механизмом рефлексии сериализатора, а не всей рефлексией приложения. Начиная с .NET 8, PublishTrimmed также отключает этот механизм, если настройка явно не переопределена. См. примечание Microsoft о совместимости с trimming.

Сериализация и десериализация с генерируемыми метаданными

Используйте этот полный Program.cs в консольном проекте .NET 8 с указанным выше свойством:

using System.Text.Json;
using System.Text.Json.Serialization;

Console.WriteLine(JsonSerializer.IsReflectionEnabledByDefault);
var widget = new Widget(42, "Ada");
string json = JsonSerializer.Serialize(widget, DemoJsonContext.Default.Widget);
Widget restored = JsonSerializer.Deserialize(json, DemoJsonContext.Default.Widget)!;
Console.WriteLine(json);
Console.WriteLine($"Round trip: {restored.Id} {restored.Name}");

public sealed record Widget(int Id, string Name);

[JsonSerializable(typeof(Widget))]
internal partial class DemoJsonContext : JsonSerializerContext { }

Результат:

False
{"Id":42,"Name":"Ada"}
Round trip: 42 Ada

[JsonSerializable] регистрирует Widget, а контекст напрямую предоставляет сгенерированный JsonTypeInfo<Widget>. Эти перегрузки не требуют отдельного объекта настроек.

Если API принимает JsonSerializerOptions, явно задайте разрешитель:

var options = new JsonSerializerOptions
{
    TypeInfoResolver = DemoJsonContext.Default
};
string json = JsonSerializer.Serialize(widget, options);

Регистрируйте фактические корневые типы, которые сериализуете, включая коллекции, когда они нужны. Для моделей с перечислениями см. JsonStringEnumConverter с Native AOT. Для повторного использования зафиксированных настроек см. MakeReadOnly и требование к разрешителю.

Запуск проверенного примера

Скачайте полный проект настроек System.Text.Json, распакуйте и выполните:

dotnet run -c Release

Проект без дополнительных зависимостей нацелен на .NET 8 и проверяет неудачные стандартные вызовы, сериализацию и обратное чтение с генерируемыми метаданными, а также путь через разрешитель настроек. Он также проверяет настройки только для чтения. Все проверки выполнены на реальных средах .NET 8.0.33 и .NET 10.0.10; отдельные команды записаны в архиве. Тот же проект также опубликован и запущен как Native AOT .NET 8 для macOS arm64. Намеренные проверки ошибок и перегрузки, связанные с рефлексией, создают предупреждения анализа; они перечислены в записи о проверке.

Сведения о поддерживаемых типах и интеграции в приложение приведены в руководстве Microsoft по генерации исходного кода.