Что такое параметр `next` в middleware ASP.NET Core?

Question

Что такое параметр `next` в middleware ASP.NET Core?

Тип вопроса: ASP.NET Core Вероятность: 25% Категория: C# Разработчик

Ответ

Параметр next в middleware ASP.NET Core — это делегат типа RequestDelegate, который представляет следующий компонент middleware в конвейере обработки запроса. Вызов await next.Invoke() передает управление следующему middleware.

Роль и поведение:

Передача управления: Без вызова next() конвейер обрывается, и последующие middleware не выполняются. Это называется short-circuiting и используется middlewareми, которые полностью обрабатывают запрос (например, UseStaticFiles или UseAuthentication для неудачной аутентификации).
Контроль потока: Позволяет выполнить код как до, так и после следующего middleware в цепочке.

Пример middleware с логированием времени выполнения:

app.Use(async (HttpContext context, RequestDelegate next) =>
{
    // Код, выполняемый ДО следующего middleware
    var stopwatch = Stopwatch.StartNew();
    Log.Information("Начало обработки запроса {Path}", context.Request.Path);

    // Передача управления следующему middleware в конвейере
    await next(context);

    // Код, выполняемый ПОСЛЕ следующего middleware
    stopwatch.Stop();
    Log.Information("Запрос {Path} обработан за {ElapsedMs} мс", 
                    context.Request.Path, stopwatch.ElapsedMilliseconds);
});

Критические аспекты:

Порядок регистрации: Порядок вызовов app.Use() или app.UseMiddleware() в Program.cs определяет порядок выполнения middleware. next всегда ссылается на следующего по списку.
Обработка исключений: Исключения, возникшие в последующих middleware, "всплывают" через вызов next(). Для их глобальной обработки используется специальное middleware app.UseExceptionHandler(), которое регистрируется первым в конвейере.
Модификация ответа: После вызова next() можно читать и, с осторожностью, модифицировать ответ (например, добавлять заголовки), но нельзя изменять тело ответа, если оно уже было отправлено клиенту.

Ответ 18+ 🔞

А, этот твой next в ASP.NET Core middleware, ну просто классика жанра, как водка под селёдку! Смотри, чтобы не запутаться, как в трёх соснах.

Представь себе конвейерную ленту на заводе, где каждый рабочий — это middleware. Вот приезжает к тебе деталь (HTTP-запрос), а next — это ты кричишь следующему мужику на линии: «Вася, бери, делай своё дело!». Если не крикнешь — всё, деталь у тебя и останется, дальше не пойдёт, конвейер встал. Это и есть short-circuiting, когда middleware решает: «Да похуй, я сам всё обработаю, дальше не пущу».

Вот смотри на примере, как засечь время обработки, чтоб знать, кто у нас тут тормозит:

app.Use(async (HttpContext context, RequestDelegate next) =>
{
    // Тут мы ДО того, как запрос попадёт в дебри приложения
    var stopwatch = Stopwatch.StartNew();
    Log.Information("Запрос {Path} припёрся, начинаем", context.Request.Path);

    // А вот это святое — крикнули следующему в цепочке
    await next(context);

    // А тут мы УЖЕ ПОСЛЕ того, как все накосячили и ответ почти готов
    stopwatch.Stop();
    Log.Information("Запрос {Path} сделан за {ElapsedMs} мс, ебать!", 
                    context.Request.Path, stopwatch.ElapsedMilliseconds);
});

Важные моменты, которые в голове держать надо, а то будет пиздец:

Порядок — всё. Как middleware в Program.cs расставил, так они и будут работать. next — это всегда следующий по списку, как в очереди за водкой. Если UseStaticFiles поставишь после своего middleware — он и next-ом вызываться будет позже. Логично? Логично.
Исключения летят вверх. Если где-то дальше по цепочке, после твоего next(), вылетит исключение — оно прилетит прямо тебе в await next(), как кирпич в окно. Поэтому умные дядьки первым делом ставят app.UseExceptionHandler() — это как подстраховочный мужик с сачком, который всех летящих тараканов ловит.
С ответом после next() — как с разбитой чашкой. Заголовки поправить ещё можно (типа context.Response.Headers.Add(...)), но если тело ответа уже начало утекать к клиенту — всё, пиши пропало, менять его нельзя. Представь, что ты уже начал кричать человеку в трубку, а потом передумал — не выйдет.

Короче, next — это твоя кнопка «пуск» для следующего участка конвейера. Не нажал — всё замерло. Нажал — поехали дальше, и можешь ещё сверху своего кода накинуть, как сверхуровень на торт. Главное — порядок не перепутай, а то получится, как в том анекдоте: «сначала надел трусы, а потом штаны».