18. リクエストのライフサイクル全体像

ここまで学んだ部品は、1つのリクエストに対して決まった順序で実行されます。大きな流れは「ミドルウェア → ガード → インターセプター(前) → パイプ → ハンドラ → インターセプター(後)」で、途中で投げられた例外は例外フィルタが受け止めます。

実務でこの順序が効いてくるのはデバッグのときです。「ガードで弾かれたリクエストはパイプに到達しない」「ミドルウェアはガードより先に動く」と知っていれば、ログがどこまで出ているかから問題の発生箇所を素早く絞り込めます。

下のコードは主要な4段階(ミドルウェア → ガード → パイプ → ハンドラ)を関数の入れ子で再現したものです。外側の関数ほど先に動き、途中で弾かれると内側は実行されない、という構造がライフサイクルの本質です。

▶ サンプルコードを実行してみよう(自由に書き換えてOK)

TypeScript

// ミドルウェア → ガード → パイプ → ハンドラ の順序を関数合成で再現
type Req = {
  method: string;
  path: string;
  authHeader: string | null;
  rawId: string;     // URL から取った文字列(パイプ適用前)
  parsedId?: number; // パイプが変換した数値
};
type Res = { statusCode: number; body: string };
type Next = (req: Req) => Res;

// 各部品は「次の処理」を包んで前後に割り込む関数として表せる
function loggerMiddleware(next: Next): Next {
  return (req) => {
    console.log("1. ミドルウェア: " + req.method + " " + req.path);
    return next(req);
  };
}

function authGuard(next: Next): Next {
  return (req) => {
    console.log("2. ガード: 認証ヘッダを確認");
    if (req.authHeader === null) {
      return { statusCode: 403, body: "Forbidden" }; // ここで打ち切り
    }
    return next(req);
  };
}

function parseIdPipe(next: Next): Next {
  return (req) => {
    console.log("3. パイプ: rawId を数値に変換");
    return next({ ...req, parsedId: parseInt(req.rawId, 10) });
  };
}

function findUserHandler(req: Req): Res {
  console.log("4. ハンドラ: id=" + req.parsedId + " のユーザーを返す");
  return { statusCode: 200, body: "user " + req.parsedId };
}

// 外側ほど先に実行される(NestJS が自動でやっている合成)
const app = loggerMiddleware(authGuard(parseIdPipe(findUserHandler)));

const okReq: Req = {
  method: "GET", path: "/users/7", authHeader: "token", rawId: "7",
};
console.log(app(okReq));

console.log("--- 認証ヘッダなしの場合(ガードで打ち切り) ---");
console.log(app({ ...okReq, authHeader: null }));

// ミドルウェア → ガード → パイプ → ハンドラ の順序を関数合成で再現
type Req = {
  method: string;
  path: string;
  authHeader: string | null;
  rawId: string;     // URL から取った文字列(パイプ適用前)
  parsedId?: number; // パイプが変換した数値
};
type Res = { statusCode: number; body: string };
type Next = (req: Req) => Res;

// 各部品は「次の処理」を包んで前後に割り込む関数として表せる
function loggerMiddleware(next: Next): Next {
  return (req) => {
    console.log("1. ミドルウェア: " + req.method + " " + req.path);
    return next(req);
  };
}

function parseIdPipe(next: Next): Next {
  return (req) => {
    console.log("3. パイプ: rawId を数値に変換");
    return next({ ...req, parsedId: parseInt(req.rawId, 10) });
  };
}

function findUserHandler(req: Req): Res {
  console.log("4. ハンドラ: id=" + req.parsedId + " のユーザーを返す");
  return { statusCode: 200, body: "user " + req.parsedId };
}

// 外側ほど先に実行される(NestJS が自動でやっている合成)
const app = loggerMiddleware(authGuard(parseIdPipe(findUserHandler)));

const okReq: Req = {
  method: "GET", path: "/users/7", authHeader: "token", rawId: "7",
};
console.log(app(okReq));

console.log("--- 認証ヘッダなしの場合(ガードで打ち切り) ---");
console.log(app({ ...okReq, authHeader: null }));

公式ドキュメントで詳しく ↗