Старый бежевый ЭЛТ-монитор с цветными блоками на экране, соединённый кабелями с современным ноутбуком, на котором схема связанных узлов: перенос сайта со старой платформы на новую

Миграция ASP.NET MVC 5 на ASP.NET Core: пошаговый план, проекты на VB.NET и подводные камни

РубрикаМиграцияУровеньСредний Чтение15 минОпубликовано ТегиASP.NET MVCASP.NET CoreVB.NETМиграция

Старый сайт на ASP.NET MVC 5 работает, но платформа больше не развивается. Разбираем, когда переносить его на ASP.NET Core, чем миграция на месте отличается от постепенного переноса через YARP, что меняется в конфигурации, аутентификации и маршрутах, как быть с кодом на VB.NET и представлениями .vbhtml и сколько это занимает.

Главное. Миграция ASP.NET MVC 5 на ASP.NET Core — это перенос контроллеров, моделей и Razor-представлений на .NET 10 с переписыванием всего, что держится на System.Web: Global.asax, Web.config, HTTP-модулей, сессии и аутентификации. Небольшие сайты переносят за один релиз, крупные — постепенно, ставя новое приложение перед старым и проксируя непереведённые разделы через YARP. Код на VB.NET остаётся в библиотеках, а представления .vbhtml переписывают на C#.

Миграция ASP.NET MVC 5 на ASP.NET Core — это перенос контроллеров, моделей и Razor-представлений на современный .NET с правками и переписывание всего, что держится на System.Web: конвейера запросов, конфигурации и аутентификации. Обычно к ней приходят, когда сайт или внутренний портал работает десять лет и всё чаще упирается в ограничения. .NET Framework 4.8 не развивается, новые библиотеки выходят только под современный .NET, хостинг на Linux недоступен, а разработчиков, готовых сопровождать Global.asax и Web.config на триста строк, становится меньше.

Миграция — не единственный вариант. Если это витрина или корпоративный сайт, где бизнес-логики мало, а дизайн и структура устарели вместе с кодом, переносить старую вёрстку часто бессмысленно. Тогда честнее заказать создание сайта на ASP.NET Core с нуля, перенести контент и сохранить адреса страниц. Переносить код имеет смысл, когда в проекте годы бизнес-логики, интеграций и правил, которые нигде, кроме кода, не описаны.

Ниже: как выбрать между миграцией на месте и постепенным переносом через прокси, что именно меняется в коде, как быть с проектами на VB.NET и представлениями .vbhtml, как не потерять пользователей и позиции в поиске и сколько это занимает. Если у вас не MVC, а Web Forms, читайте отдельный план миграции Web Forms на ASP.NET Core и Blazor: там другие проблемы и другие решения.

Зачем переходить с ASP.NET MVC 5 на ASP.NET Core?

Переходить стоит тогда, когда старая платформа начинает мешать развитию: новые версии библиотек, хостинг, производительность и найм. Само приложение при этом может работать без сбоев. ASP.NET MVC 5 работает только на .NET Framework, а последняя версия .NET Framework, 4.8.1, получает исправления безопасности вместе с Windows, но новых возможностей в ней не будет.

Практические причины выглядят так:

  • Библиотеки. Новые версии популярных пакетов (клиенты облачных сервисов, драйверы баз данных, генераторы PDF) всё чаще выходят только для современного .NET. Старый проект застревает на версиях трёх-пятилетней давности, включая уязвимые.
  • Хостинг. ASP.NET Core работает на Linux в контейнере или за Nginx. Для MVC 5 нужен Windows Server с IIS, а это лицензии и отдельный администратор.
  • Производительность. Kestrel, асинхронный конвейер и современный сборщик мусора на тех же серверах обслуживают больше запросов, чем конвейер System.Web.
  • Поддержка и люди. Актуальная LTS-версия .NET 10 поддерживается до ноября 2028 года (политика поддержки .NET). Разработчики на рынке знают ASP.NET Core, а MVC 5 для многих уже история.

Если у вас ещё .NET 8 или 9, имейте в виду: их поддержка закончилась 10 ноября 2026 года, подробности в разборе о завершении поддержки .NET 8 и 9. Мигрировать сегодня имеет смысл сразу на .NET 10.

Мигрировать, переписать или оставить как есть?

Мигрировать стоит, если ценность сайта в коде; переписать, если ценность в контенте; оставить, если сайт доживает последние годы и почти не меняется. Ниже — таблица, по которой удобно принять решение вместе с владельцем продукта.

СитуацияЧто выбратьПочему
Портал с большой бизнес-логикой, расчётами, интеграциями с 1С или ERPМиграция кодаЛогика проверена годами, переписать её без ошибок дороже, чем перенести
Корпоративный сайт или витрина, логики мало, дизайн устарелНовый сайтСтарая вёрстка и структура не нужны, переносить нечего, кроме контента и URL
Внутреннее приложение, которое меняют раз в год и выводят через 2–3 годаОставить на MVC 5Платформа поддерживается вместе с Windows; хватит обновления пакетов и защиты
Большой проект, остановить разработку на полгода нельзяПостепенная миграцияСтарое и новое приложения работают рядом, разделы переносятся по одному
Код на VB.NET, представления .vbhtmlМиграция с переписыванием представленийRazor в ASP.NET Core поддерживает только C#

Перед решением полезно оценить объём работ хотя бы грубо: число контроллеров и представлений, количество использований HttpContext.Current, сторонние пакеты без версии под современный .NET. Как превратить это в оценку в часах, описано в материале о стоимости миграции legacy-приложения.

Миграция на месте или постепенный перенос: что выбрать?

Для небольших сайтов подходит миграция на месте, для крупных и живых проектов — постепенный перенос по шаблону Strangler Fig. Так формулирует и Microsoft в руководстве по миграции с ASP.NET Framework: чем больше приложение и зависимость от System.Web, тем безопаснее переносить частями.

Миграция на месте

При миграции на месте новое приложение заменяет старое за один релиз: создаётся проект ASP.NET Core, в него переносится весь код, приложение тестируется и выкладывается.

  • Плюсы: нет периода, когда живут две системы, не нужны прокси и общая сессия.
  • Минусы: пока идёт перенос, новые функции приходится делать дважды или замораживать.
  • Кому подходит: сайтам до 20–30 контроллеров с умеренной логикой.

Постепенный перенос через прокси

Перед старым приложением ставится новое на ASP.NET Core. Всё, что уже перенесено, оно обслуживает само, а остальные запросы проксирует в старое приложение через YARP. Пользователь видит один сайт, а раздел за разделом переезжает в новую платформу. Когда в старом приложении не остаётся маршрутов, его выключают.

Минимальная настройка новой стороны выглядит так:

Program.csC#
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllersWithViews();
builder.Services.AddHttpForwarder();
// Общая сессия и аутентификация со старым приложением
builder.Services.AddSystemWebAdapters()
    .AddRemoteAppClient(o =>
    {
        o.RemoteAppUrl = new(builder.Configuration["RemoteAppUri"]!);
        o.ApiKey = builder.Configuration["RemoteAppApiKey"]!;
    })
    .AddSessionClient()
    .AddAuthenticationClient(true);

var app = builder.Build();

app.UseStaticFiles();
app.UseRouting();
app.UseAuthentication();
app.UseAuthorization();
app.UseSystemWebAdapters();

app.MapDefaultControllerRoute();
// Всё, чего ещё нет в новом приложении, уходит в старое MVC 5
app.MapForwarder("/{**catch-all}", app.Configuration["RemoteAppUri"]!)
   .WithOrder(int.MaxValue)
   .ShortCircuit();

app.Run();

Ключевая деталь — пакет Microsoft.AspNetCore.SystemWebAdapters. Он даёт перенесённому коду знакомый API HttpContext и позволяет обоим приложениям видеть одну сессию и одного вошедшего пользователя. Без этого пользователь, перешедший со старой страницы на новую, внезапно оказывается разлогинен. Подробности настройки — в документации по адаптерам System.Web.

Что меняется в коде при переходе на ASP.NET Core?

Меняется инфраструктура вокруг контроллеров: точка входа, конфигурация, конвейер запросов, внедрение зависимостей и работа с контекстом запроса. Сами контроллеры и Razor-представления переносятся с небольшими правками. Таблица соответствий для типичного проекта:

ASP.NET MVC 5ASP.NET CoreЧто делать
Global.asax, App_StartProgram.csРегистрацию маршрутов, фильтров и бандлов перенести в построитель приложения
Web.config (appSettings, connectionStrings)appsettings.json, переменные окруженияЧитать через IConfiguration или типизированные IOptions<T>
HTTP-модули и обработчикиMiddlewareПереписать каждый модуль как компонент конвейера; порядок регистрации важен
HttpContext.CurrentIHttpContextAccessor, параметр действияУбрать статический доступ, передавать контекст через DI
Autofac, Unity, NinjectВстроенный контейнер DIПростые регистрации перенести, сложные можно оставить на Autofac
System.Web.Optimization (бандлы)WebOptimizer или сборка фронтендаЗаменить @Styles.Render и @Scripts.Render на обычные теги
Дочерние действия Html.ActionView ComponentsПеренести логику в компонент с методом InvokeAsync
HttpPostedFileBaseIFormFileПоправить сигнатуры действий загрузки файлов
Web API 2 (ApiController)Контроллеры с атрибутом [ApiController]MVC и Web API в Core — одна модель, отдельный проект не нужен
Entity Framework 6EF Core или EF 6.5 на .NETEF 6 работает на современном .NET, переход на EF Core можно отложить
machineKeyData Protection APIНужен для общих cookie со старым приложением, см. ниже

Конфигурация и секреты

Раз уж Web.config всё равно разбирается по строкам, вынесите заодно пароли и строки подключения из репозитория. В ASP.NET Core настройки складываются из нескольких источников: appsettings.json, файл окружения, переменные окружения сервера, хранилище секретов. Трансформации Web.Release.config больше не нужны.

Сессия и кэш

Сессия в ASP.NET Core выключена по умолчанию и хранит только байты и строки. Если старый код клал в Session целые объекты, корзину или DataTable, их придётся сериализовать в JSON. Заодно проверьте, что вообще живёт в сессии: нередко там годами копятся данные, которым место в базе.

Entity Framework

Переписывать доступ к данным одновременно с переносом веб-слоя — частая ошибка, которая удваивает риск. EF 6 начиная с версии 6.3 работает на современном .NET, поэтому сначала переносят веб-часть на EF 6, а переход на EF Core делают отдельным этапом, когда сайт уже стабильно работает на новой платформе.

Как быть с проектом на VB.NET и представлениями .vbhtml?

Код на VB.NET в ASP.NET Core можно сохранить в библиотеках классов, но Razor-представления .vbhtml придётся переписать на C#. Razor в ASP.NET Core поддерживает только C#, шаблонов веб-проектов на VB.NET нет, а примеры в документации и сообществе почти все на C#.

Рабочая схема для VB-проектов такая:

  1. Вынести логику в библиотеки. Сервисы, расчёты, модели и доступ к данным на VB.NET переводятся в библиотеку классов, нацеленную на net10.0. VB.NET в библиотеках полностью поддерживается, а код без System.Web обычно компилируется почти без правок.
  2. Сделать веб-проект на C#. Новый проект ASP.NET Core с контроллерами и представлениями на C# ссылается на VB-библиотеки. Контроллеры получаются тонкими: принять запрос, вызвать сервис, вернуть представление.
  3. Переписать представления. Синтаксис Razor на C# и VB отличается в основном конструкциями: @Code ... End Code становится @{ ... }, @ModelType — @model, If ... Then — if (...) { }. Работа механическая, ИИ-ассистенты её ускоряют, но глазами всё равно придётся пройти каждое представление.

Пример: сервис на VB.NET остаётся в библиотеке без изменений и регистрируется в контейнере нового приложения.

InvoiceService.vbVB.NET
' Библиотека Company.Billing, TargetFramework net10.0
Public Interface IInvoiceService
    Function GetTotal(invoiceId As Integer) As Decimal
End Interface

Public Class InvoiceService
    Implements IInvoiceService

    Private ReadOnly _db As BillingContext

    Public Sub New(db As BillingContext)
        _db = db
    End Sub

    Public Function GetTotal(invoiceId As Integer) As Decimal _
        Implements IInvoiceService.GetTotal
        Return _db.InvoiceLines.
            Where(Function(l) l.InvoiceId = invoiceId).
            Sum(Function(l) l.Qty * l.Price)
    End Function
End Class

' В Program.cs веб-проекта на C#:
' builder.Services.AddScoped<IInvoiceService, InvoiceService>();

Главное препятствие при выносе логики — обращения к HttpContext.Current, Session и Server.MapPath прямо из бизнес-кода. Их нужно заменить параметрами или интерфейсами до переноса. Если тестов нет, сначала напишите хотя бы характеризационные тесты на расчёты, как описано в материале о модульном тестировании legacy-кода на VB.NET.

Как перенести аутентификацию и не разлогинить пользователей?

Пользователи не заметят переезда, если сохранить их пароли и, при постепенном переносе, общий cookie входа. Для этого надо заранее разобраться, какая аутентификация стоит в старом проекте.

  • ASP.NET Identity 2.x. Схема таблиц в ASP.NET Core Identity отличается: добавлены поля NormalizedUserName, NormalizedEmail, ConcurrencyStamp, таблицы AspNetRoleClaims и AspNetUserTokens. Их добавляют миграцией базы и заполняют. Хеши паролей старого формата стандартный PasswordHasher проверяет и при следующем входе пересчитывает в новый формат.
  • Membership, SimpleMembership, своя таблица пользователей. Потребуется собственная реализация IPasswordHasher, которая умеет проверять старые хеши. Сбрасывать пароли всем пользователям — худший вариант.
  • Windows-аутентификация. На IIS работает через модуль ASP.NET Core; на Linux нужна Negotiate-аутентификация и настройка Kerberos.

При постепенном переносе оба приложения должны понимать один cookie. Старое приложение переводят с machineKey на общий ключ Data Protection, как описано в руководстве по замене machineKey, либо используют удалённую аутентификацию через адаптеры System.Web.

Как сохранить URL и позиции в поиске?

Позиции сайта сохраняются, если после миграции каждая страница отвечает по тому же адресу с тем же содержимым, а изменившиеся адреса отдают постоянный редирект 301. Маршрутизация ASP.NET Core по умолчанию совместима с привычным шаблоном {controller}/{action}/{id?}, но детали расходятся чаще, чем кажется.

  1. Выгрузите все URL до миграции. Из карты сайта, логов IIS за 2–3 месяца и данных Search Console и Яндекс.Вебмастера. Это эталон, по которому вы проверите новую версию.
  2. Проверьте регистр и завершающий слэш. Старый сайт мог отвечать и на /Catalog/Item/5, и на /catalog/item/5/. Выберите одну форму и настройте 301 для остальных через middleware UseRewriter.
  3. Перенесите атрибутные маршруты. [RoutePrefix] из MVC 5 в Core заменяется на [Route] на контроллере; проверьте каждый.
  4. Сохраните мета-теги и разметку. Title, description, canonical и микроразметка часто собирались в _Layout через ViewBag — при переписывании макета их легко потерять.
  5. Прогоните эталонный список по новой версии. Скрипт обходит все URL и проверяет код ответа, title и canonical. Любой 404 по старому адресу — это потерянный трафик.

Пошаговый план миграции

Миграция проходит восемь этапов, от инвентаризации до отключения старого приложения. План подходит для обоих подходов; при постепенном переносе шаги 5–7 повторяются для каждого раздела сайта.

  1. Инвентаризация. Список контроллеров, представлений, HTTP-модулей, пакетов NuGet и мест, где используется System.Web. Агент модернизации GitHub Copilot app modernization и .NET Upgrade Assistant дают такой отчёт автоматически.
  2. Обновление пакетов на старой стороне. Поднять пакеты до последних версий, совместимых с .NET Framework 4.8, и убрать неиспользуемые. Каждый пакет, у которого нет версии под современный .NET, — отдельная задача.
  3. Сборка и тесты в конвейере. До переноса нужна автоматическая сборка и хотя бы дымовые тесты, иначе регрессии будут находить пользователи. Как это настроить, разобрано в материале о CI/CD для legacy-проекта на .NET Framework.
  4. Вынос логики в библиотеки. Бизнес-код освобождается от System.Web и переводится в библиотеки с несколькими целевыми платформами, чтобы на время переноса их использовали оба приложения.
  5. Новый веб-проект. ASP.NET Core на .NET 10, конфигурация, DI, аутентификация, общий макет. При постепенном переносе — прокси YARP и адаптеры System.Web.
  6. Перенос контроллеров и представлений. По разделам, начиная с простых и наиболее посещаемых. Для каждого — сверка с эталонным списком URL.
  7. Тестирование и выкладка. Сравнительное тестирование старой и новой версии на одних данных, нагрузочный прогон, выкладка с возможностью быстро переключиться назад.
  8. Отключение старого приложения. Когда трафик в старое приложение упал до нуля, его выключают, а прокси убирают.

Сколько времени занимает миграция?

Срок зависит не от числа строк кода, а от того, насколько глубоко код завязан на System.Web и сколько в проекте сторонних компонентов без замены. Ориентиры из практики для команды из 1–2 разработчиков:

Размер проектаПризнакиОриентир срока
Небольшой сайтдо 20 контроллеров, Identity, без сложных интеграций3–6 недель
Средний портал30–80 контроллеров, свои HTTP-модули, Web API, отчёты2–4 месяца
Крупная системасотни представлений, VB.NET, сторонние контролы, общая сессия с другими приложениями6–12 месяцев постепенного переноса

Сильнее всего сроки растягивают сторонние серверные контролы (старые версии Telerik, DevExpress, генераторы отчётов вроде Crystal Reports), у которых нет прямого аналога под ASP.NET Core, и представления на VB. Их стоит найти на этапе инвентаризации и оценить отдельно.

Типичные ошибки при миграции

  • Переписать всё сразу. Веб-платформу, ORM, фронтенд и дизайн меняют одновременно, а потом неделями ищут, на каком из слоёв сломалось.
  • Заморозить разработку без срока. Бизнес не готов полгода жить без изменений, и в старом проекте появляются правки, которые забывают перенести. Постепенный перенос решает эту проблему.
  • Забыть про фоновые задачи. Таймеры в Global.asax, Hangfire, задачи в планировщике Windows, которые дергают URL сайта. В ASP.NET Core их переносят в BackgroundService или отдельный сервис.
  • Потерять культуру и форматы. Разбор дат и десятичных чисел зависит от настроек globalization в Web.config. В Core культуру задают явно через UseRequestLocalization, иначе суммы «1,5» начинают разбираться как 15.
  • Не проверить старые URL. Главная открывается, все довольны, а через неделю Search Console показывает сотни 404 по адресам, которые приводили трафик.

Чек-лист перед выкладкой

  1. Все URL из эталонного списка отвечают 200 или 301 на правильный адрес.
  2. Пользователи входят со старыми паролями, восстановление пароля работает.
  3. Title, description, canonical и микроразметка совпадают со старой версией.
  4. Загрузка и скачивание файлов, экспорт в Excel и PDF проверены на реальных данных.
  5. Фоновые задачи и рассылки работают и не дублируются старым приложением.
  6. Культура, часовой пояс и форматы чисел совпадают со старой версией.
  7. Логи и мониторинг ошибок подключены до выкладки, а не после.
  8. Есть способ за минуты вернуть трафик на старое приложение.

Как это делают сегодня

В 2026 году инвентаризацию и черновой перенос кода всё чаще отдают GitHub Copilot app modernization: агент оценивает решение, строит план и переносит типовые места. Проверку маршрутов, аутентификации, культуры и представлений по-прежнему делают люди, и именно на неё уходит основное время.

Вопросы и ответы о миграции ASP.NET MVC 5 на ASP.NET Core

Можно ли запустить ASP.NET MVC 5 на .NET 10 без переписывания?

Нет. ASP.NET MVC 5 построен на System.Web и работает только на .NET Framework. Контроллеры и представления переносятся в ASP.NET Core с правками, а конвейер запросов, конфигурацию и аутентификацию приходится переписать.

Сколько поддерживается ASP.NET MVC 5 и .NET Framework 4.8?

.NET Framework 4.8.1 поддерживается как компонент Windows и получает исправления безопасности, но новых возможностей в нём не будет. Поэтому немедленно мигрировать не обязательно, но новые библиотеки и хостинг на Linux старому проекту недоступны.

Можно ли оставить код на VB.NET после миграции?

Да, в библиотеках классов: сервисы, модели и доступ к данным на VB.NET полностью работают на .NET 10. Представления .vbhtml придётся переписать на C#, потому что Razor в ASP.NET Core поддерживает только C#.

Что выбрать: миграцию на месте или постепенный перенос?

Миграция на месте подходит для сайтов до 20–30 контроллеров, которые можно заморозить на время переноса. Крупные проекты переносят постепенно: новое приложение на ASP.NET Core проксирует непереведённые разделы в старое через YARP, а адаптеры System.Web держат общую сессию и вход.

Потеряет ли сайт позиции в поиске после миграции?

Нет, если каждая страница сохранит адрес, title, description и canonical, а изменившиеся адреса отдадут редирект 301. Для этого до миграции выгружают все URL из карты сайта, логов и Search Console и проверяют их на новой версии.

Нужно ли сразу переходить с Entity Framework 6 на EF Core?

Не обязательно. EF 6 начиная с версии 6.3 работает на современном .NET, поэтому веб-слой обычно переносят на EF 6, а переход на EF Core делают отдельным этапом, чтобы не смешивать два источника регрессий.

Читайте также