1. マイクロフロントエンド概念
2016年の末に初めて定義された概念で、1つの大規模なフロントエンドアプリケーションを、複数の小さくて独立したフロントエンドモジュールに分割し、それぞれを独立して開発・デプロイ・運用できる構造
2. 背景・構造
- バックエンド領域がマイクロサービス化されているが、フロントエンドはモノリシックなまま
モノリシック構造の問題点
従来のフロントエンドの課題
- コードベースの肥大化 → 理解が困難になる
- ビルド・デプロイ時間の増加
- 複数のチームが同じコードにアクセス → コンフリクトの発生
チーム単位での開発の難しさ
- 例:開発チームが4つに分かれていても、1つのコードベースしか管理できない
- チーム間での作業分担が難しくなり、ボトルネックが発生
拡張性・再利用性の限界
- 機能を拡張するたびに既存アプリの構造を変更する必要がある
- 他のプロジェクト間でコードを再利用するのが難しい
3. メリット・デメリット・導入時の検討基準
✅ メリット
- チームの独立性を確保できる
- 迅速なリリースが可能(CI/CD の強化)
- 異なる技術スタックの併用が可能
- 優れた拡張性を実現できる
⚠️ デメリット
- 初期設定が複雑(Webpack、ルーティング、状態共有など)
- バンドルの最適化が必要(ライブラリの重複)
- 共通状態(例:ログイン、テーマなど)の一元管理が困難
🔍 導入時の検討ポイント
- プロジェクトの規模が十分に大きいこと
- チーム構成がドメインごとに分かれていること
- 長期的な保守性の観点からメリットがあること
- 小規模なアプリやグローバルな状態共有が必要なプロジェクトでマイクロフロントエンドを使用すると、複雑さが増し、労力に見合わない場合がある
4. 実装・技術
🔗 マイクロフロントエンドの統合方式
🕒 統合のタイミング(いつ統合するか)
-
ビルド時統合(Build-time Integration)
- 各マイクロアプリをビルド時に結合して1つのアプリとしてデプロイ
- 実装が比較的簡単だが、CI/CD に影響を与えやすく、結合度が高い
-
ランタイム統合(Runtime Integration)
- 実行時にアプリを分割して読み込み、統合
- 柔軟で独立性が高く、Module Federation や single-spa などと相性が良い
| 比較項目 | ランタイム統合 | ビルド時統合 |
|---|---|---|
| 実装の難易度 | 高い | 低い |
| デプロイの柔軟性 | 高い | 低い |
| コンテナとアプリの結合度 | 低い | 高い |
※ 一般的に「マイクロフロントエンド」と言うとランタイム統合を指すことが多い
📍 統合の場所(どこで統合するか)
-
サーバーサイド統合(Server-side Composition)
- サーバーで HTML やコンテンツを合成してクライアントへ返す
- SSR(Server-Side Rendering)と組み合わせやすい
-
クライアントサイド統合(Client-side Composition)
- 各マイクロアプリを JavaScript 経由で読み込み、レンダリング
- SPAや動的ルーティングに適する
-
エッジ統合(Edge-side Composition)
- CDN やエッジロジックで各アプリを統合
- パフォーマンス面では有効だが、設計が複雑になる
✅ランタイム+クライアントサイド統合の例
🌐 Webpack Module Federation
- Webpack 5のModule Federation機能は、ランタイム統合を代表する技術である
- この方式では、ホストアプリケーションがリモートアプリケーションをランタイムに読み込み、まるで1つのアプリのように統合
- 「ホスト(Host)」は他のマイクロフロントエンドを統合するメインアプリケーション
- 「リモート(Remote)」はホストから読み込まれるサブアプリケーション
// host-app/webpack.config.js
const ModuleFederationPlugin = require('webpack/lib/container/ModuleFederationPlugin');
module.exports = {
plugins: [
new ModuleFederationPlugin({
name: 'host',
remotes: {
productApp: 'productApp@http://localhost:3001/remoteEntry.js',
cartApp: 'cartApp@http://localhost:3002/remoteEntry.js',
},
}),
],
};
// product-app/webpack.config.js
const ModuleFederationPlugin = require('webpack/lib/container/ModuleFederationPlugin');
module.exports = {
plugins: [
new ModuleFederationPlugin({
name: 'productApp',
filename: 'remoteEntry.js',//「productApp」が自分のコンポーネントを他のアプリから使えるようにするエントリーポイントの役割
exposes: {
'./ProductList': './src/components/ProductList',
'./ProductDetail': './src/components/ProductDetail',
},
}),
],
};
他の例
- Single-spa
- Web Components
- iframe
- Qiankun
5. 問題点・課題
✅ Q1:異なるフレームワークを使えるか?
- 可能ですが、現実的には保守と統合の複雑性が大きいため、フレームワークを統一するのが一般的
- 異なるフレームワークを混在させると以下の課題が発生:
- スタイルやレンダリングの衝突
- ライブラリのバージョン不一致(例:React 17 と React 18 の競合)
- 状態管理ツール(Redux / Pinia / RxJS など)の非互換
- タイプセーフティの低下
- 有効なケース
- レガシーアプリの段階的なモダナイズが必要な場合
- チームごとに使用する技術スタックが異なるグローバル開発環境など
- そのような構成を採用する際は、window や CustomEvent を使った疎結合な通信設計が重要
✅ Q2:状態をどう共有するか?
-
モジュールが独立しているため、通常の Redux / Pinia などを直接共有するのは困難
-
例:ログイン情報、テーマ、言語設定 などを全アプリで使いたい場合
-
解決策
-
windowグローバル状態を使う// Shellアプリで window.__APP_STATE__ = { user: {}, setUser(user) { this.user = user; window.dispatchEvent(new CustomEvent('user-updated')); } }; // Microアプリで window.addEventListener('user-updated', () => { const user = window.__APP_STATE__.user; // ローカル状態を更新 }); -
CustomEventを使ったイベント通信// アプリA(ログイン成功時) window.dispatchEvent(new CustomEvent('login-success', { detail: userInfo })); // アプリB(ユーザー情報を受け取る) window.addEventListener('login-success', (e) => { const user = e.detail; }); -
Shellアプリ側で Context や Redux を管理し、各アプリに渡す(※ ただしこれは React アプリ間でのみ有効)
-
localStorage / sessionStorage に保存して共有
📌 状態の種類に応じて適切な方式を選ぶことがポイント!
状態の種類 推奨される共有方式 ログイン情報、トークン localStorage + CustomEvent テーマ、言語設定 window グローバル変数 or ブラウザ保存 ページ遷移制御 Shell アプリ経由で管理 Redux や Context Shell で提供 & Module Federationで expose -
https://micro-frontends.org/
https://oliveyoung.tech/2025-06-29/what-is-MFE-part1/
https://zenn.dev/kmdmnak/articles/041f798d04ba76
https://github.com/module-federation/module-federation-examples/tree/master

