👻

レイヤードアーキテクチャを導入して分かったメリットとデメリット

に公開
2026/01/12

こんにちは、新卒2年目のはよちゃんです。

小規模プロジェクトにおいて、ごちゃっとした構成からレイヤードアーキテクチャへ移行する経験をしました。本記事では、その過程で感じたメリット・デメリットについて、簡単ではありますが整理してまとめます。

レイヤードアーキテクチャの概要

まず、本文へ入る前にレイヤードアーキテクチャをざらっと説明します。
下記は、オライリーが出版する「アーキテクチャの基礎」の抜粋です。

論理的な水平方向のレイヤーとして編成される。各レイヤーは、アプリケーション内で特定の役割(プレゼンテーションロジックやビジネスロジックなど)を果たす。存在しなければならないレイヤーの数や種類については特に制限はないが、ほとんどのレイヤードアーキテクチャは、プレゼンテーション層、ビジネス層、永続化層、データベース層の4つの標準的なレイヤーで構成されている。

簡潔ではありますが、初見では具体的なイメージを持ちづらい説明ですよね...

上記の「レイヤー」とは、技術によって論理的に分割された構造のことを指しています。
具体的な役割はプロジェクトごとに異なりますが、バックエンドにおける、おおよその役割は以下の通りです。

  • プレゼンテーション層:
    • HTTP リクエストの受付とレスポンス返却のみを担当します。
  • コンバート層:
    • リクエスト値を受け入れ可能な形式へ変換し、値の正当性を保証します。
    • ※この層は、レイヤードアーキテクチャで明示的に定義されているものではありません。
  • ビジネス層:
    • 業務フローを表します。例えば、永続化層からデータを取得し、値の計算やデータの集約などを行います。
  • 永続化層:
    • データの取得・保存・削除を担当します。

Web API における処理の流れと責務境界を示した自作図

採用した背景

背景

  • 1つのファイルで各 API のエンドポイントを実装。
  • GET のエンドポイントを実装するだけで、600 行を超えるコード量になっていました。

問題

  • 既存コードと似た処理を実装する際に、
    • どこを変更すべきか分かりづらい状態。
    • エラー発生時の調査範囲が広くなっていました...

目的

  • ファイル分割による開発速度の向上
  • エラー発生時の調査範囲の縮小

結果

  • 目的は達成。
  • ただし、これは小規模プロジェクトだったからこそ得られた効果だと考えています。

この点については、後述するデメリットで触れます。

メリット

1. 実装を再利用しやすい

  • 例として、全件取得エンドポイントを考えます。
    • 実態が「DB から取得するだけ」の場合、
    • repository のクエリの一部を変更するだけで対応可能です。
  • router / convert / usecase / repository は、既存実装を流用できます。

結果として、

  • 実装時に意識すべき点は差分のみ。
  • エラーハンドリングも自然に統一されます。

2. 変更範囲を限定しやすい

  • 例として、multipart/form-data で image / video のみを通過させたい場合を考えます。
  • convert 層に実装すればよく、
    • 他の層を意識する必要がありません。

※ 厳密な検証を行う場合は他の層にも影響する可能性がありますが、
アプリケーション都合で素早く変更したい場合には有効だと考えています。


3. エラーの範囲を特定しやすい

レイヤード構成により、以下の点が明確になります。

  • どの層でエラーが発生したのか
  • どこまでエラーが伝播してよいのか
  • どの層でエラーを解釈・変換すべきか

各層の役割が固定化されているため、

  • エラーメッセージから処理内容を逆算しやすくなります。
  • 例えば、引数が undefined の場合でも、
    • どこで値が生成されたのかを追いやすくなります。

デメリット

1. 単純な処理の冗長化

レイヤード前

  • 処理の流れは直感的です。
  • ただし、プレゼンテーション層 が以下のすべてを担っています。
    • バリデーション
    • 業務処理
    • 永続化
    • レスポンス生成
// node.jsのmulterライブラリで画像を保存するケース(端折ってます)
router.post("/", upload.single("file"), async (req, res) => {
  try {
    const id = await createImage();
    if (!req.file) return res.status(400).json({ error: "Invalid file" });
    saveFile(id, req.file);
    res.status(201).location(`/images/${id}`).end();
  } catch {
    res.status(500).json({ error: "Internal Server Error" });
  }
});

レイヤード後

  • 各層の責務は明確になります。
  • しかし、単純な処理であっても各層を実装する必要があり、
    レイヤード前と比較すると冗長になる場合があります。
// プレゼンテーション層
router.post("/", upload.single("file"), async (req, res) => {
  try {
      const file = convertFile(req.file);
      const result = await createImage(file);
      return handleResponse(result, res);
  } catch {
    res.status(500).json({ error: "Internal Server Error" });
  }
});
// コンバート層
export function convertFile(file) {
  if (!isValidFile(file)) return error("Invalid File");
  return { buffer: file.buffer, name: file.originalname };
}
// ビジネス層
export async function createImage(file) {
  const id = await imageRepository.create();
  await imageFileRepository.save(id, file);
  return id;
}
// 永続化層
export async function save(id, file) {
  await fs.writeFile(getPath(id), file.buffer);
}

2. ドメイン増加に伴うコード量の増加

  • ドメインごとに最低限必要なコードが発生します。

  • 特に usecase 層で顕著です。

    • try-catch の増加
    • ボイラープレートコード の増加

共通化を util に寄せすぎると、

  • 予期せぬ依存が生じる可能性。
  • 影響範囲が不透明になる恐れも。

そのため、場合によっては
技術的な分割ではなく、ドメイン単位で分割する方が合理的なケースもあると考えています。

コードの冗長化をどう扱うか(おまけ)

エラーハンドリングの観点から...

router 層で毎回 try-catch を行い、
その場で res.status(...).json(...) を返す実装は分かりやすいです。

しかし、この方法では、

  • エンドポイントごとに分岐が増加。
  • エラー条件が増えるほど可読性が低下します。

そこで導入の際は、

  • 各層は「処理の失敗」を返すだけに留め、
  • HTTP レスポンスへの変換は router 層に集約しています。

本記事では詳細な実装までは扱いませんが、
このようなエラー表現の抽象化は、
レイヤードアーキテクチャと相性が良いと考えています。

Discussion