Исправление несоответствия версий System.Text.Json в ASP.NET Core 8.0 на Linux

Ваше приложение ASP.NET Core 8.0 ищет версию System.Text.Json 9.0.0.0 из-за транзитивных зависимостей от Serilog или других пакетов, которые ссылаются на более новую версию .NET, вероятно, вызвано несоответствием версий SDK или конфликтами версий пакетов при переходе с Windows на Linux. Это обычно происходит, когда среда сборки использует другую версию .NET SDK, чем целевая версия вашего проекта, создавая перенаправления привязок сборок, которые ссылаются на неправильные версии. Решение включает закрепление версии SDK, обновление ссылок на пакеты или добавление явных привязок версий для разрешения конфликта зависимостей.

Содержание

• Понимание проблемы несоответствия версий
• Основные причины конфликтов версий System.Text.Json
• Пошаговые решения
• Предотвращение будущих конфликтов версий

Понимание проблемы несоответствия версий

Ошибка, с которой вы столкнулись, когда ваше приложение ASP.NET Core 8.0 ищет System.Text.Json версии 9.0.0.0 вместо 8.0.6, является распространенной проблемой привязки сборок, которая возникает при перемещении приложений между средами разработки. Эта проблема особенно характерна для сценариев развертывания при переходе с Windows на Linux.

Ключевое замечание: Сообщение об ошибке “Не удалось загрузить файл или сборку ‘System.Text.Json, Version=9.0.0.0’” указывает на то, что среда выполнения пытается загрузить версию сборки, которая не существует в вашем развернутом приложении, обычно из-за неправильного разрешения зависимостей в процессе сборки.

Согласно документации Microsoft, эта проблема часто возникает из-за того, что среда размещения разрешает зависимости против неправильной версии SDK, вызывая конфликты версий, которые проявляются при развертывании.

Основные причины конфликтов версий System.Text.Json

Несоответствие версий SDK

Основной причиной этой проблемы обычно является несоответствие версий SDK между вашей средой разработки и целевой средой развертывания. При перемещении вашего приложения с Windows на Linux система сборки могла использовать другую версию .NET SDK, чем та, на которую фактически нацелен ваш проект.

Как отмечено в обсуждении Microsoft Q&A, “среда размещения разрешает зависимости против неправильной версии SDK, версии 9.0.0 той же сборки” - этот сценарий точно соответствует вашей ситуации.

Зависимости пакетов Serilog

Ваше конкретное упоминание о том, что ошибка возникает в конфигурации Serilog, указывает на то, что пакет Serilog.AspNetCore или его зависимости могут подтягивать более новую версию System.Text.Json, чем ожидалось.

Из результатов исследования мы видим, что у пакетов Serilog были известные проблемы с версиями System.Text.Json. Выпуски Serilog.AspNetCore упоминают обновления “для избежания транзитивной зависимости от уязвимой версии System.Text.Json”, что указывает на проблемы управления версиями зависимостей.

Конфликты версий пакетов

Другой распространенной причиной являются конфликты транзитивных зависимостей, когда разные пакеты в дереве зависимостей ссылаются на разные версии System.Text.Json. Когда система сборки разрешает эти зависимости, она может выбрать версию, несовместимую с вашей целевой платформой.

В обсуждении на Stack Overflow объясняется, что “System.Text.Json изменился в .NET Core 3.0, они внесли изменения в некоторые типы в пространстве имен System.Text.Json” и что “использование .NET Core сборок с .NET библиотеками классов обычно не очень хорошо смешивается”.

Пошаговые решения

Решение 1: Создание файла global.json

Наиболее надежным решением является явное закрепление версии .NET SDK путем создания файла global.json в корне вашего репозитория:

{
  "sdk": {
    "version": "8.0.100"
  }
}

Это гарантирует, что независимо от версий SDK, установленных на сборочной машине, ваш проект всегда будет использовать правильную версию .NET 8 SDK. Как рекомендуется в Microsoft Q&A, “создайте global.json в корне вашего репозитория, чтобы закрепить версию SDK”.

Решение 2: Обновление ссылок на пакеты Serilog

Проверьте версии ваших пакетов Serilog и убедитесь, что они совместимы с .NET 8.0:

dotnet add package Serilog.AspNetCore --version 8.0.0
dotnet add package Serilog.Settings.Configuration --version 8.0.0

В NuGet Gallery четко указано: “Если вы нацелены на .NET 8.x, выберите версию Serilog.AspNetCore 8.x, и так далее”. Использование пакетов версии 9.x действительно подтянет System.Text.Json 9.0.0.

Решение 3: Явная привязка версии пакета

Если предыдущие решения не работают, явно привяжитесь к правильной версии System.Text.Json в вашем файле .csproj:

<ItemGroup>
  <PackageReference Include="System.Text.Json" Version="8.0.6" />
</ItemGroup>

Вам также может потребоваться добавить перенаправления привязок в ваш appsettings.json или создать файл runtimeconfig.json с правильными привязками версий.

Решение 4: Очистка и пересборка

Иногда проблема сохраняется из-за кэшированных артефактов сборки. Выполните полную очистку и пересборку:

dotnet clean
dotnet restore
dotnet publish -c Release

Это гарантирует, что все ссылки на зависимости будут разрешены правильно и не останется устаревших артефактов.

Предотвращение будущих конфликтов версий

Использование центрального управления пакетами

Рассмотрите возможность использования центрального управления пакетами для контроля версий пакетов во всем решении:

<PropertyGroup>
  <CentralPackageTransitivePinningEnabled>true</CentralPackageTransitivePinningEnabled>
</PropertyGroup>

Это помогает предотвратить конфликты версий, гарантируя, что все проекты используют одинаковые версии пакетов.

Регулярное обновление зависимостей

Периодически проверяйте и обновляйте ваши зависимости для обеспечения совместимости:

dotnet list package --outdated

Это покажет вам пакеты, для которых доступны более новые версии, позволяя проактивно решать потенциальные проблемы совместимости.

Конфигурация CI/CD конвейера

Если вы используете CI/CD конвейеры, явно укажите версию .NET SDK в конфигурации вашего конвейера:

- task: UseDotNet@2
  inputs:
    packageType: 'sdk'
    version: '8.0.x'

Как отмечено в исследовании, явная установка правильной SDK перед сборкой может предотвратить многие проблемы, связанные с версиями.

Заключение

Проблема несоответствия версий System.Text.Json, с которой вы столкнулись, является распространенной проблемой развертывания при перемещении приложений ASP.NET Core между средами. Реализуя закрепление версии SDK с помощью файла global.json, обеспечивая совместимость ваших пакетов Serilog с .NET 8.0 и явно управляя зависимостями пакетов, вы можете решить эту проблему и предотвратить будущие конфликты. Помните, что несоответствия версий часто возникают из-за транзитивных зависимостей, поэтому внимательно просмотрите все дерево зависимостей, а не только прямые ссылки на пакеты. Регулярное обслуживание ссылок на пакеты и конфигурации CI/CD конвейера поможет поддерживать согласованность развертывания в различных средах.

Источники

1. ASP.NET Core 8.0 web app on Linux looking for System.Text.Json 9.0.0.0 - Stack Overflow
2. Web App Deployment Error Due to System.Text.Json Version Mismatch - Microsoft Q&A
3. Releases · serilog/serilog-aspnetcore
4. NuGet Gallery | Serilog.AspNetCore 9.0.0
5. System.Text.Json version conflict - Stack Overflow
6. Could not load file or assembly ‘System.Text.Json’ - Stack Overflow