用微前端的方式搭建类单页应用-InfoQ

抖音技术能力大揭密！钜惠大礼、深度体验，尽在火山引擎增长沙龙，就等你来！立即报名>> 了解详情 



 写点什么

前言

微前端由 ThoughtWorks 2016 年提出，将后端微服务的理念应用于浏览器端，即将 Web 应用由单一的单体应用转变为多个小型前端应用聚合为一的应用。

美团已经是一家拥有几万人规模的大型互联网公司，提升整体效率至关重要，这需要很多内部和外部的管理系统来支撑。由于这些系统之间存在大量的连通和交互诉求，因此我们希望能够按照用户和使用场景将这些系统汇总成一个或者几个综合的系统。

我们把这种由多个微前端聚合出来的单页应用叫做“类单页应用”，美团 HR 系统就是基于这种设计实现的。美团 HR 系统是由 30 多个微前端应用聚合而成，包含 1000 多个页面，300 多个导航菜单项。对用户来说，HR 系统是一个单页应用，整个交互过程非常顺畅；对开发者同学来说，各个应用均可独立开发、独立测试、独立发布，大大提高了开发效率。

接下来，本文将为大家介绍“微前端构建类单页应用”在美团 HR 系统中的一些实践。同时也分享一些我们的思考和经验，希望能够对大家有所启发。

HR 系统的微前端设计

因为美团的 HR 系统所涉及项目比较多，目前由三个团队来负责。其中：OA 团队负责考勤、合同、流程等功能，HR 团队负责入职、转正、调岗、离职等功能，上海团队负责绩效、招聘等功能。这种团队和功能的划分模式，使得每个系统都是相对独立的，拥有独立的域名、独立的 UI 设计、独立的技术栈。但是，这样会带来开发团队之间职责划分不清、用户体验效果差等问题，所以就迫切需要把 HR 系统转变成只有一个域名和一套展示风格的系统。

为了满足公司业务发展的要求，我们做了一个 HR 的门户页面，把各个子系统的入口做了链接归拢。然而我们发现 HR 门户的意义非常小，用户跳转两次之后，又完全不知道跳到哪里去了。因此我们通过将 HR 系统整合为一个应用的方式，来解决以上问题。

一般而言，“类单页应用”的实现方式主要有两种：

iframe 嵌入
微前端合并类单页应用

其中，iframe 嵌入方式是比较容易实现的，但在实践的过程中带来了如下问题：

子项目需要改造，需要提供一组不带导航的功能
iframe 嵌入的显示区大小不容易控制，存在一定局限性
URL 的记录完全无效，页面刷新不能够被记忆，刷新会返回首页
iframe 功能之间的跳转是无效的
iframe 的样式显示、兼容性等都具有局限性

考虑到这些问题，iframe 嵌入并不能满足我们的业务诉求，所以我们开始用微前端的方式来搭建 HR 系统。

在这个微前端的方案里，有几个我们必须要解决的问题：

一个前端需要对应多个后端
提供一套应用注册机制，完成应用的无缝整合
构建时集成应用和应用独立发布部署

只有解决了以上问题，我们的集成才是有效且真正可落地的，接下来详细讲解一下这几个问题的实现思路。

一个前端对应多个后端

HR 系统最终线上运行的是一个单页应用，而项目开发中要求应用独立，因此我们新建了一个入口项目，用于整合各个应用。在我们的实践中，把这个项目叫做“Portal 项目”或“主项目”，业务应用叫做“子项目”，整个项目结构图如下所示：

项目结构图

“Portal 项目”是比较特殊的，在开发阶段是一个容器，不包含任何业务，除了提供“子项目”注册、合并功能外，还可以提供一些系统级公共支持，例如：

用户登录机制
菜单权限获取
全局异常处理
全局数据打点

“子项目”对外输出不需要入口 HTML 页面，只需要输出的资源文件即可，资源文件包括 js、css、fonts 和 imgs 等。

HR 系统在线上运行了一个前端服务（Node Server），这个 Server 用于响应用户登录、鉴权、资源的请求。HR 系统的数据请求并没有经过前端服务做透传，而是被 Nginx 转发到后端 Server 上，具体交互如下图所示：

前后端分离图

转发规则上限制数据请求格式必须是 系统名+Api做前缀 这样保障了各个系统之间的请求可以完全隔离。其中，Nginx 的配置示例如下：

server {  listen     80;  server_name   xxx.xx.com;
  location /project/api/ {    set $upstream_name "server.project";    proxy_pass http://$upstream_name;  }  ...
  location / {    set $upstream_name "web.portal";    proxy_pass http://$upstream_name;  }}

复制代码

我们将用户的统一登录和认证问题交给了 SSO，所有的项目的后端 Server 都要接入 SSO 校验登录状态，从而保障业务系统间用户安全认证的一致性。

在项目结构确定以后，应用如何进行合并呢？因此，我们开始制定了一套应用注册机制。

应用注册机制

“Portal 项目”提供注册的接口，“子项目”进行注册，最终聚合成一个单页应用。在整套机制中，比较核心的部分是路由注册机制，“子项目”的路由应该由自己控制，而整个系统的导航是“Portal 项目”提供的。

路由注册

路由的控制由三部分组成：权限菜单树、导航和路由树，“Portal 项目”中封装一个组件 App，根据菜单树和路由树生成整个页面。路由挂载到 DOM 树上的代码如下：

let Router = <Router      fetchMenu = {fetchMenuHandle}      routes = {routes}      app = {App}      history = {history}      >ReactDOM.render(Router,document.querySelector("#app"));

复制代码

Router 是在 react-router 的基础上做了一层封装，通过 menu 和 routes 最后生成一个如下所示的路由树：

 <Router>  <Route path="/" component={App}>   <Route path="/namespace/xx" component={About} />   <Route path="inbox" component={Inbox}>    <Route path="messages/:id" component={Message} />   </Route>  </Route> </Router>

复制代码

具体注册使用了全局的window.app.routes，“Portal 项目”从window.app.routes获取路由，“子项目”把自己需要注册的路由添加到window.app.routes中，子项目的注册如下:

let app = window.app = window.app || {}; app.routes = (app.routes || []).concat([{ code:'attendance-record', path: '/attendance-record', component: wrapper(() => async(require('./nodes/attendance-record'), 'kaoqin')),}]);

复制代码

路由合并的同时也把具体的功能做了引用关联，再到构建时就可以把所有的功能与路由管理起来。项目的作用域要怎么控制呢？我们要求“子项目”间是彼此隔离，要避免样式污染，要做独立的数据流管理，我们用项目作用域的方式来解决这些问题。

项目作用域控制

在路由控制的时候我们提到了 window.app，我们也是通过这个全局 App 来做项目作用域的控制。window.app包含了如下几部分：

let app = window.app || {};app = {  require:function(request){...},  define:function(name,context,index){...},  routes:[...],  init:function(namespace,reducers){...}};

复制代码

window.app 主要功能：

define 定义项目的公共库，主要用来解决 JS 公共库的管理问题
require 引用自己的定义的基础库，配合 define 来使用
routes 用于存放全局的路由，子项目路由添加到 window.app.routes，用于完成路由的注册
init 注册入口，为子项目添加上 namesapce 标识，注册上子项目管理数据流的 reducers

子项目完整的注册，如下所示：

import reducers from './redux/kaoqin-reducer';let app = window.app = window.app || {}; app.routes = (app.routes || []).concat([{ code:'attendance-record', path: '/attendance-record', component: wrapper(() => async(require('./nodes/attendance-record'), 'kaoqin')), // ... 其他路由}]);
function wrapper(loadComponent) { let React = null; let Component = null; let Wrapped = props => (  <div className="namespace-kaoqin">   <Component {...props} />   ); return async () => {  await window.app.init('namespace-kaoqin',reducers);  React = require('react');  Component = await loadComponent();  return Wrapped; };}

复制代码

其中做了这几件事情：

把路由添加到 window.app 中
业务第一次功能被调用的时候执行 window.app.init(namespace,reducers)，注册项目作用域和数据流的 reducers
对业务功能的挂载节点包装一个根节点：Component挂载在className为namespace-kaoqin的div下面

这样就完成了“子项目”的注册，“子项目”的对外输出是一个入口文件和一系列的资源文件，这些文件由 webpack 构建生成。

CSS 作用域方面，使用 webpack 在构建阶段为业务的所有 CSS 都加上自己的作用域，构建配置如下：

//webpack打包部分，在postcss插件中 添加namespace的控制config.postcss.push(postcss.plugin('namespace', () => css => css.walkRules(rule => {  if (rule.parent && rule.parent.type === 'atrule' && rule.parent.name !== 'media') return;  rule.selectors = rule.selectors.map(s => `.namespace-kaoqin ${s === 'body' ? '' : s}`); })));

复制代码

CSS 处理用到 postcss-loader，postcss-loader 用到 postcss，我们添加 postcss 的处理插件，为每一个 CSS 选择器都添加名为.namespace-kaoqin的根选择器，最后打包出来的 CSS，如下所示：

.namespace-kaoqin .attendance-record {  height: 100%;  position: relative}
.namespace-kaoqin .attendance-record .attendance-record-content {  font-size: 14px;  height: 100%;  overflow: auto;  padding: 0 20px}...

复制代码

CSS 样式问题解决之后，接下来看一下，Portal 提供的 init 做了哪些工作。

let inited = false;let ModalContainer = null;app.init = async function (namespace,reducers) { if (!inited) {  inited = true;  let block = await new Promise(resolve => {   require.ensure([], function (require) {    app.define('block', require.context('block', true, /^\.\/(?!dev)([^\/]|\/(?!demo))+\.jsx?$/));    resolve(require('block'));   }, 'common');  });  ModalContainer = document.createElement('div');  document.body.appendChild(mtfv3ModalContainer);  let { Modal} = block;  Modal.getContainer = () => ModalContainer; } ModalContainer.setAttribute('class', `${namespace}`); mountReducers(namepace,reducers)};

复制代码

init 方法主要做了两件事情：

挂载“子项目”的 reducers，把“子项目”的数据流挂载了 redux 上
“子项目”的弹出窗全部挂载在一个全局的 div 上，并为这个 div 添加对应的项目作用域，配合“子项目”构建的 CSS，确保弹出框样式正确

上述代码中还看到了app.define的用法，它主要是用来处理 JS 公共库的控制，例如我们用到的组件库 Block，期望每个“子项目”的版本都是统一的。因此我们需要解决 JS 公共库版本统一的问题。

JS 公共库版本统一

为了不侵入“子项目”，我们采用构建过程中替换的方式来做，“Portal 项目”把公共库引入进来，重新定义，然后通过window.app.require的方式引用，在编译“子项目”的时候，把引用公共库的代码从require('react')全部替换为window.app.require('react')，这样就可以将 JS 公共库的版本都交给“Portal 项目”来控制了。

define 的代码和示例如下：

/*** 重新定义包* @param name 引用的包名，例如 react* @param context 资源引用器 实际上是 webpackContext（是一个方法，来引用资源文件）* @param index 定义的包的入口文件*/app.define = function (name, context, index) { let keys = context.keys(); for (let key of keys) {  let parts = (name + key.slice(1)).split('/');  let dir = this.modules;  for (let i = 0; i < parts.length - 1; i++) {   let part = parts[i];   if (!dir.hasOwnProperty(part)) {    dir[part] = {};   }   dir = dir[part];  }  dir[parts[parts.length - 1]] = context.bind(context, key); } if (index != null) {  this.modules[name]['index.js'] = this.modules[name][index]; }};//定义app的react //定义一个react资源库：把原来react根目录和lib目录下的.js全部获取到，绑定到新定义的react中，并指定react.js作为入口文件app.define('react', require.context('react', true, /^.\/(lib\/)?[^\/]+\.js$/), 'react.js');app.define('react-dom', require.context('react-dom', true, /^.\/index\.js$/));

复制代码

“子项目”的构建，使用 webpack 的 externals（外部扩展）来对引用进行替换：

/** * 对一些公共包的引用做处理 通过webpack的externals（外部扩展）来解决 */const libs = ['react', 'react-dom', "block"];
module.exports = function (context, request, callback) {  if (libs.indexOf(request.split('/', 1)[0]) !== -1) {    //如果文件的require路径中包含libs中的 替换为 window.app.require('${request}');     //var在这儿是声明的意思     callback(null, `var window.app.require('${request}')`);  } else {    callback();  }};