C# ASP.NET CoreミドルウェアとHttpModuleの違いを徹底解説

ASP.NET Coreへの移行を検討する際、多くの開発者が疑問に抱くのが「従来のHttpModuleとミドルウェア（Middleware）は何が違うのか」という点です。本記事では、両者の構成方法や実行順序の制御性、ホストへの依存度などの違いをわかりやすく比較し、あわせてカスタムミドルウェアの実装例もご紹介します。

HttpModuleの特徴

HttpModuleは、web.configまたはglobal.asaxを使って構成されます。この方式には以下のような制約があります。

• 開発者がモジュールの実行順序を直接制御できない
• モジュールの順序は主にアプリケーションのライフサイクルイベントに基づいて決まる
• そのため、リクエスト時とレスポンス時で実行順序が同じになる
• アプリケーションイベントに固有のコードをアタッチする用途に適している
• System.Webに強く紐づいているため、IIS環境への依存が生じやすい

ASP.NET Coreミドルウェアの特徴

一方、ミドルウェアはweb.configではなく、アプリケーションのエントリポイントであるStartup.csのコード内で構成されます。これにより次のようなメリットが得られます。

• どの処理を実行し、どの順序で実行するかを完全に制御できる（追加された順番に実行される）
• レスポンスに対するミドルウェアの実行順序は、リクエスト時と逆順になる（パイプラインの往復構造）
• HttpModuleのようなライフサイクルイベントに依存しない
• ホストに依存しないため、IISだけでなくKestrelなど任意のサーバーで動作する

ASP.NET Coreの組み込みミドルウェア

ASP.NET Coreには、よく使われる機能が組み込みミドルウェアとして提供されています。

• Authentication（認証）：認証機能のサポートを提供
• CORS：オリジン間リソース共有（Cross-Origin Resource Sharing）の設定
• Routing（ルーティング）：リクエストルートの定義と制約
• Session（セッション）：ユーザーセッション管理のサポート
• Diagnostics（診断）：エラーページやランタイム情報の表示機能

カスタムミドルウェアの実装例

ここでは、リクエストパイプラインに独自の処理を追加するカスタムミドルウェアの例を示します。

public class MyMiddleware
{
    private readonly RequestDelegate _next;
    private readonly ILogger _logger;

    public MyMiddleware(RequestDelegate next, ILoggerFactory logFactory)
    {
        _next = next;
        _logger = logFactory.CreateLogger("MyMiddleware");
    }

    public async Task Invoke(HttpContext httpContext)
    {
        _logger.LogInformation("MyMiddleware executing..");
        await _next(httpContext); // 次のミドルウェアを呼び出す
    }
}

// HTTPリクエストパイプラインへミドルウェアを登録するための拡張メソッドです。

public static class MyMiddlewareExtensions
{
    public static IApplicationBuilder UseMyMiddleware(this IApplicationBuilder builder)
    {
        return builder.UseMiddleware<MyMiddleware>();
    }
}

// Use拡張メソッドを使って、カスタムミドルウェアをリクエストパイプラインに追加します。

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    app.UseMiddleware<MyMiddleware>();

    app.Run(async (context) =>
    {
        await context.Response.WriteAsync("Hello World!");
    });
}

まとめ

HttpModuleがweb.configやglobal.asaxによる構成とイベント駆動であるのに対し、ASP.NET CoreのミドルウェアはStartup.csでのコードベース構成により、実行順序や処理内容を柔軟に制御できます。またホスト非依存であるため、クロスプラットフォーム環境でも一貫した動作が期待できます。新規開発ではミドルウェアを採用するのが現代的なベストプラクティスといえるでしょう。