浅入深出的微前端MicroApp

导读 本文将深入浅出地探讨微前端架构模式——MicroApp，从微前端的基本概念、核心优势以及如何在现代web开发中实现它，详解微前端如何使得大型应用能够分解为小型、简单、可独立开发和部署的子应用，同时还能保持各个子应用间的完整性和协调性。此外，本文还将探讨实施微前端时可能遇到的挑战和最佳实践，为开发者提供一条清晰的实施路径，帮助其构建更加灵活和可维护的前端生态系统。

01 前言

在今年的敏捷团队建设中，我通过Suite执行器实现了一键自动化单元测试。Juint除了Suite执行器还有哪些执行器呢？由此我的Runner探索之旅开始了！

本文是由作者最近做的一个项目有感而发，因为之前做了一些技术栈的统一，为了用ant Design的pro-table，PC统一使用react，但是有一些老的项目是vue的，本次新页面较多，老页面的改动较少，除此之外老项目想换菜单，因此想借助本次机会用react开发，经过了几番思考，发现本次很适合用微前端来完成本次需求，最终决定用react搭建一个基座（主应用），将原来的vue项目接入到基座，这样不仅实现了新页面react开发，而且老项目也能和新项目融合一起。

02 微前端的概念

理解，首先 MCube 会依据模板缓存状态判断是否需要网络获取最新模板，当获取到模板后进行模板加载，加载阶段会将产物转换为视图树的结构，转换完成后将通过表达式引擎解析表达式并取得正确的值，通过事件解析引擎解析用户自定义事件并完成事件的绑定，完成解析赋值以及事件绑定后进行视图的渲染，最终将目标页面展示到屏幕。

什么是微前端？微前端是借鉴了微服务的架构理念，它既可以将多个项目融合为一，又可以减少项目之间的耦合，提升项目扩展性，相比一整块的前端仓库，微前端架构下的前端仓库倾向于更小更灵活，有一个基座应用（主应用），来管理各个子应用的加载和卸载，所以微前端不是指具体的库，不是指具体的框架，不是指具体的工具，而是一种理想与架构模式，微前端的核心三大原则：独立运行、独立部署、独立开发。

03 何时使用微前端？

理解，首先 MCube 会依据模板缓存状态判断是否需要网络获取最新模板，当获取到模板后进行模板加载，加载阶段会将产物转换为视图树的结构，转换完成后将通过表达式引擎解析表达式并取得正确的值，通过事件解析引擎解析用户自定义事件并完成事件的绑定，完成解析赋值以及事件绑定后进行视图的渲染，最终将目标页面展示到屏幕。

（1）一个非常庞大的项目，越来越大，后续难以维护。

（2）在一些大厂，经常会有跨部门和跨团队协作开发项目，这样会导致团队效率降低和沟通成本加大，这时我们可以使用微前端，每个团队或者每个部门单独维护自己的项目，我们只需要一个主项目来把分散的子项目汇集到一起即可。

（3）一个非常老旧的项目，开发效率低，但是一时半会又不能全部重构，这时我们就可以新创建一个新技术新项目的基座，把老项目的页面接入到新项目里面，后面新需求都在新项目里面开发就好，不用再动老项目。

（4）想独立部署每一个单页面应用。

（5）改善初始化加载时间，延迟加载代码。

（6）基于多页的子应用缺乏管理，规范/标准不统一，无法统一控制视觉呈现、共享功能和依赖，造成重复工作。

04 如何创建微前端基座？

理解，首先 MCube 会依据模板缓存状态判断是否需要网络获取最新模板，当获取到模板后进行模板加载，加载阶段会将产物转换为视图树的结构，转换完成后将通过表达式引擎解析表达式并取得正确的值，通过事件解析引擎解析用户自定义事件并完成事件的绑定，完成解析赋值以及事件绑定后进行视图的渲染，最终将目标页面展示到屏幕。

4.1 微前端框架选型

4.1.1 现有框架

1. single-spa是一个将多个单页面应用聚合为一个整体应用的 JavaScript 微前端框架。

2. qiankun 基于 single-spa 封装的微前端框架。

3. MicroApp 京东出品，一款基于WebComponent的思想，轻量、高效、功能强大的微前端框架。

本次项目使用的是umi+react+ts的技术栈，其实比较适合用qiankun，qiankun继承了umi框架，但是这个框架配置起来比较麻烦。

4.1.2 MicroApp优势

1、使用起来成本最低，将所有的页面封装到一个类WebComponent组件中，从而实现在主应用基座中嵌入一行代码即可渲染一个微前端应用。

2、不需要像 single-spa 和 qiankun 一样要求子应用修改渲染逻辑并暴露出方法，也不需要修改webpack配置，是目前市面上接入微前端成本最低的方案。

3、提供了 js沙箱、样式隔离、元素隔离、预加载、数据通信、静态资源补全等一系列完善的功能。

4、没有任何依赖，这赋予它小巧的体积和更高的扩展性。

5、为了保证各个业务之间独立开发、独立部署的能力，micro-app做了诸多兼容，在任何技术框架中都可以正常运行。

MicroApp的概念图如下图所示：

4.2 场景演示

以后台管理系统为例

最外层是基座，基座是微前端应用集成的一个重要平台，同时也肩负着管理公共资源、依赖、规范的责任，主要有以下职责：

（1）子应用集成，给子应用提供渲染容器

（2）权限管理

（3）会话管理

（4）路由、菜单管理

（5）主题管理

（6）共享依赖

（7）多语言管理（最重要的一点）

content里面可以任意放不同技术的子应用，只需要开发一个主应用（主应用也可以自由选择语言，目前支持react、vue、vite、angular、next.js、nuxt.js），将一些分散的应用接进来，主应用还可以通过控制权限，让不同的账号看到的菜单不一样，即看到不同系统的页面，通过同一个地址访问到不同的子应用。

4.3 搭建微前端基座

以react基座为例

1、创建项目

（1）首先确保本地node版本>= 14（推荐用nvm来管理 node 版本，windows 下推荐用nvm-windows）

（2）通过官网提供命令可以快速创建一个基于 UMI 的项目作为主应用，也就是所谓的基座

（3）安装依赖

npm i @micro-zoe/micro-app --save

package.json文件里面dependencies里面会多一行代码，看到下面代码则表示项目已经具备micro-app接入能力了。

"@micro-zoe/micro-app": "^1.0.0-alpha.7"

（4）在入口引入micro-app

首先在根目录下创建一个global.tsx文件

import microApp from '@micro-zoe/micro-app'

microApp.start()

（5）在主应用引入子应用

a. 分配一个子应用路由

 {
    path: '/yp',
    name: 'yp',
    linkHidden: true,
    linkDisable: true,
    breadcrumbClose: true,
    component: '@/pages/yp-app',
  }

b. 子应用的文件

在pages文件下创建一个yp-app（子应用的文件）

// name(必传)：应用名称 // url(必传)：应用地址，会被自动补全为http://localhost:3000/index.html

import React from 'react';
import config from '@/config';

// /** @jsxRuntime classic */
// /** @jsx jsxCustomEvent */
// import jsxCustomEvent from '@micro-zoe/micro-app/polyfill/jsx-custom-event';

export default (): React.ReactElement => {

  // 子应用点击了面包屑的回到首页
  const onDispathChild = (e: any) => {
    const { isBackHome } = e.detail.data;
    if (isBackHome) window.location.href = '/';
  };

  return (
    <>
      <micro-app name="yp" url={config?.yp} onDataChange={onDispathChild} />
    </>
  );
};

说明：onDataChange方法是子应用和主应用的信息通讯方法，micro-app 在 window 下面挂载了一个全局的对象，只需要去触发它提供的方法，完成主子之间的通信即可，不管是交互逻辑还是数据传递逻辑，就都通了。

c.主应用成功引入子应用（子应用是VUE项目）

到目前为止如果项目不存在跨域问题，子应用就已成功接入了主应用，项目左侧是主应用，中间模块是子应用，里面包含子应用的整个模块菜单和列表，考虑到菜单统一放到主应用（基座）方便管理，需要把子应用的页面的菜单以及一些不必要的东西删除，然后把子项目一些公共样式公共布局等都统一调整下即可，最终可以得到一个主应用+子应用页面最终页面，到这里你就成功接入了第一个子应用，后续应用按照同样步骤。

接入完成不代表子应用里面所有的模块都能用了，此时还需要检查导出和导入的接口是获取域名里面的还是单独定义的，如果获取域名里面的前缀，此时导入导出不能正常使用，需要重新给导入导出单独定义，比如在子应用创建一个单独的host.js文件，引用根据环境区分到处的域名前缀。

2、路由跳转

通过主应用的菜单跳转到对应子应用的路由

//config.ts
let config = {
  yp: 'https://xxx.xxx.com:7000',//本地环境子应用的路由前缀
};

const isEnvPro = process.env.NODE_ENV === 'production';

if (isEnvPro) {
  config = {
    yp: 'https://xxx.xxx.com',//预发环境环境子应用的路由前缀
  };
}

export default config;
//以上是config.ts文件的全部-----end


//菜单点击事件里面的内容

history.push('/yp'); //切换到子应用

setTimeout(() => {
    microApp.router.push({
      name: 'yp',//和子应用的name要保持一致，为了匹配到对应子应用的路由
      path: `${config.yp}${item.url}`,
    }); //跳转子应用的路由，其中config是上面的配置文件，根据不同的环境取对应环境的子应用，item是当前点击的菜单路径信息
}, 500);

这里解释下为什么要用setTimeout，首先通过history.push('/yp')切换到子应用，防止切换过去之后短时间内找不到子应用的路由，所以加个延迟能够准确的跳转到子应用对应的路由。

3、设置跨域

（1）如果仅仅本地跨域的话可以给子应用设置，在webpack-dev-server的headers中设置跨域支持：

devServer: {
  headers: {
    'Access-Control-Allow-Origin': '*',
  }
},

这个有相对应的文档，根据子应用的语言设置不同的跨域信息。

（2）如果是接口跨域。

那么就需要找后端设置允许前端跨域的代码了，以Java为例：

@Override
    public void init(FilterConfig filterConfig) {
        this.origins = Lists.newArrayList("http://localhost:8088",
            "https://xx.xxx.com",
            "https://xx.aaa.com:8088",
            "https://xx.bbb.com:7000");
    }

这个是基础配置，还可以改成同域名下的所有都允许跨域，最好不要设置成'*'，这样很不安全。

4、代理配置

如果遇见主应用本地访问不到子应用本地，访问的一直是预发或者线上，这时候需要首先考虑代理是否配对，比如作者之前的一个子项目，如下所示：

proxy: (() => {
  return {
    //  本地访问预发
    '/avoid': {
      target: 'https://xx.xxx.com',
      changeOrigin: true,
      bypass: (req) => {
        if(req.headers.accept.indexOf('html') !== -1 ) {
          return '/index'
        }
      },
    }
  }
})()

最初本地代理是路由里面包含'/'就代理到预发上，正常单独访问子应用的链接，可以正常访问本地代理预发的接口，但是放到主应用里面就不可以了，最后给代理改成了整个项目公共部分/avoid，解决了此问题，不一定项目是因为这个，但是可以从代理入手查找问题。

5、数据通讯

micro-app提供了一套灵活的数据通信机制，方便基座应用和子应用之间的数据传输。

正常情况下，基座应用和子应用之间的通信是绑定的，基座应用只能向指定的子应用发送数据，子应用只能向基座发送数据，这种方式可以有效的避免数据污染，防止多个子应用之间相互影响。

同时也提供了全局通信，方便跨应用之间的数据通信。

子应用获取来自基座应用的数据，以及基座应用向子应用发送数据，基座应用获取来自子应用的数据，全局数据通讯详细参考https://zeroing.jd.com/docs.html#/zh-cn/data

05 总结

理解，首先 MCube 会依据模板缓存状态判断是否需要网络获取最新模板，当获取到模板后进行模板加载，加载阶段会将产物转换为视图树的结构，转换完成后将通过表达式引擎解析表达式并取得正确的值，通过事件解析引擎解析用户自定义事件并完成事件的绑定，完成解析赋值以及事件绑定后进行视图的渲染，最终将目标页面展示到屏幕。

通过上述介绍可以知道，采用微前端架构的好处就是，将原本运行已久、没有任何关联的几个应用融合为一个应用，或者将很多个小型单个应用融合为一个完整的应用，可以减少项目之间的耦合，提升项目扩展性，micro-app借鉴了WebComponent的思想，通过CustomElement结合自定义的ShadowDom，将微前端封装成一个类WebComponent组件，从而实现微前端的组件化渲染。并且由于自定义ShadowDom的隔离特性，也不需要修改webpack配置，是目前市面上接入微前端成本最低的方案，因此也得到广大程序员的青睐。

虽说微前端已经是一个非常成熟的领域了，使用微前端目的就是为了降本提效，但是在现在的这个开源大环境，使用哪种框架，或者自己实现微前端都可以，个人觉得应该考虑如果当前的项目接入微服务之后，变得维护成本更高，那就要考虑是否适合微前端了，并不能为了用而用，微前端并不是适合所有的场景，遇到问题尝试着去考虑多种方案方案解决。