MFE微前端基础版：Angular + Module Federation + webpack + 路由（Route way）完整示例

1. 项目结构

microfrontend-demo/
├── shell/                # 主应用 (Shell)
├── mfe1/                 # 微前端应用1
├── mfe2/                 # 微前端应用2
└── shared/               # 共享库

2. 主应用 (Shell) 配置

shell/webpack.config.js

const ModuleFederationPlugin = require("webpack/lib/container/ModuleFederationPlugin");
const mf = require("@angular-architects/module-federation/webpack");
const path = require("path");

module.exports = {
  output: {
    uniqueName: "shell",
    publicPath: "auto"
  },
  optimization: {
    runtimeChunk: false
  },
  plugins: [
    new ModuleFederationPlugin({
      remotes: {
        "mfe1": "mfe1@http://localhost:4201/remoteEntry.js",
        "mfe2": "mfe2@http://localhost:4202/remoteEntry.js"
      },
      shared: {
        "@angular/core": { singleton: true, strictVersion: true },
        "@angular/common": { singleton: true, strictVersion: true },
        "@angular/router": { singleton: true, strictVersion: true },
        "@angular/common/http": { singleton: true, strictVersion: true },
        // 其他共享库...
      }
    })
  ]
};

shell/src/app/app-routing.module.ts

使用：RouterModule.forRoot(routes)

import { NgModule } from '@angular/core';
import { RouterModule, Routes } from '@angular/router';

const routes: Routes = [
  {
    path: '',
    pathMatch: 'full',
    redirectTo: 'home'
  },
  {
    path: 'home',
    loadChildren: () => import('./home/home.module').then(m => m.HomeModule)
  },
  {
    path: 'mfe1',
    loadChildren: () => import('mfe1/Module').then(m => m.Mfe1Module)
  },
  {
    path: 'mfe2',
    loadChildren: () => import('mfe2/Module').then(m => m.Mfe2Module)
  },
  {
    path: '**',
    redirectTo: 'home'
  }
];

@NgModule({
  imports: [RouterModule.forRoot(routes)],
  exports: [RouterModule]
})
export class AppRoutingModule { }

shell/src/app/app.module.ts

import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { AppComponent } from './app.component';
import { AppRoutingModule } from './app-routing.module';
import { RouterModule } from '@angular/router';

@NgModule({
  declarations: [AppComponent],
  imports: [
    BrowserModule,
    RouterModule,
    AppRoutingModule
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

3. 微前端应用1 (MFE1) 配置

mfe1/webpack.config.js

只需导出包含所有路由配置的Module即可

const ModuleFederationPlugin = require("webpack/lib/container/ModuleFederationPlugin");
const mf = require("@angular-architects/module-federation/webpack");
const path = require("path");

module.exports = {
  output: {
    uniqueName: "mfe1",
    publicPath: "auto"
  },
  optimization: {
    runtimeChunk: false
  },
  plugins: [
    new ModuleFederationPlugin({
      name: "mfe1",
      filename: "remoteEntry.js",
      exposes: {
        './Module': './src/app/mfe1/mfe1.module.ts',
      },
      shared: {
        "@angular/core": { singleton: true, strictVersion: true },
        "@angular/common": { singleton: true, strictVersion: true },
        "@angular/router": { singleton: true, strictVersion: true },
        // 其他共享库...
      }
    })
  ]
};

mfe1/src/app/mfe1/mfe1.module.ts

使用 RouterModule.forChild(routes) 时，若未将所有路由配置集中在一个模块中，则需在每个组件内单独添加 RouterModule.forChild([{path:'',component:''}]) 配置。

import { NgModule } from '@angular/core';
import { CommonModule } from '@angular/common';
import { RouterModule, Routes } from '@angular/router';
import { Mfe1Component } from './mfe1.component';

const routes: Routes = [
  { path: '', component: Mfe1Component },
  { path: 'details', loadChildren: () => import('./details/details.module').then(m => m.DetailsModule) }
];

@NgModule({
  declarations: [Mfe1Component],
  imports: [
    CommonModule,
    RouterModule.forChild(routes)
  ]
})
export class Mfe1Module { }

4. 微前端应用2 (MFE2) 配置

mfe2/webpack.config.js

只需导出包含所有路由配置的Module即可

const ModuleFederationPlugin = require("webpack/lib/container/ModuleFederationPlugin");
const mf = require("@angular-architects/module-federation/webpack");
const path = require("path");

module.exports = {
  output: {
    uniqueName: "mfe2",
    publicPath: "auto"
  },
  optimization: {
    runtimeChunk: false
  },
  plugins: [
    new ModuleFederationPlugin({
      name: "mfe2",
      filename: "remoteEntry.js",
      exposes: {
        './Module': './src/app/mfe2/mfe2.module.ts',
      },
      shared: {
        "@angular/core": { singleton: true, strictVersion: true },
        "@angular/common": { singleton: true, strictVersion: true },
        "@angular/router": { singleton: true, strictVersion: true },
        // 其他共享库...
      }
    })
  ]
};

mfe2/src/app/mfe2/mfe2.module.ts

使用 RouterModule.forChild(routes) 时，若未将所有路由配置集中在一个模块中，则需在每个组件内单独添加 RouterModule.forChild([{path:'',component:''}]) 配置。

import { NgModule } from '@angular/core';
import { CommonModule } from '@angular/common';
import { RouterModule, Routes } from '@angular/router';
import { Mfe2Component } from './mfe2.component';

const routes: Routes = [
  { path: '', component: Mfe2Component },
  { path: 'settings', loadChildren: () => import('./settings/settings.module').then(m => m.SettingsModule) }
];

@NgModule({
  declarations: [Mfe2Component],
  imports: [
    CommonModule,
    RouterModule.forChild(routes)
  ]
})
export class Mfe2Module { }

5. 共享库配置

shared/package.json

{
  "name": "shared",
  "version": "1.0.0",
  "peerDependencies": {
    "@angular/core": "^15.0.0",
    "@angular/common": "^15.0.0",
    "@angular/router": "^15.0.0"
  }
}

6. 导航组件示例

shell/src/app/nav/nav.component.ts

import { Component } from '@angular/core';
import { Router } from '@angular/router';

@Component({
  selector: 'app-nav',
  template: `
    <nav>
      <button (click)="navigateTo('home')">Home</button>
      <button (click)="navigateTo('mfe1')">MFE1</button>
      <button (click)="navigateTo('mfe2')">MFE2</button>
    </nav>
  `
})
export class NavComponent {
  constructor(private router: Router) {}

  navigateTo(route: string): void {
    this.router.navigate([route]);
  }
}

7. 环境配置

shell/src/environments/environment.ts

export const environment = {
  production: false,
  mfe1Url: 'http://localhost:4201/remoteEntry.js',
  mfe2Url: 'http://localhost:4202/remoteEntry.js'
};

8. 启动脚本

在 package.json 中添加并行启动脚本：

"scripts": {
  "start": "npm-run-all --parallel start:shell start:mfe1 start:mfe2",
  "start:shell": "ng serve shell -o --port 4200",
  "start:mfe1": "ng serve mfe1 -o --port 4201",
  "start:mfe2": "ng serve mfe2 -o --port 4202"
}