微前端与项目实施方案研究

一、前言

微前端(micro-frontends)是近几年在前端领域出现的一个新概念，主要内容是将前端应用分解成一些更小、更简单的能够独立开发、测试、部署的小块，而在用户看来仍然是内聚的单个产品。微前端的理念源于微服务，是将庞大的整体拆成可控的小块，并明确它们之间的依赖关系，而它的价值在于能将低耦合的代码与组件进行组合，基座+基础协议模式能接入大量应用，进行统一的管理和输出，许多公司与团队也都在不断尝试和优化相关解决技术与设计方案，为这一概念的落地和推广添砖加瓦。结合自身遇到的问题，适时引用微前端架构能起到明显的提效赋能作用。

二、背景

目前我司拥有大量的内部系统，这些系统采用相同的技术栈，在实际开发和使用过程中，逐渐暴露出如下几个问题：

1.有大量可复用的部分，虽然有组件库，但是依赖版本难统一；
2.静态资源体积过大，影响页面加载和渲染速度；
3.应用切换目前是通过链接跳转的方式实现，会有白屏和等待时长的问题，对用户体验不够友好；
针对上述几个问题，决定采用微前端架构对内部系统进行统一的管理，本文也是围绕微前端落地的技术预研方案。

三、方案调研

目前业界有多种解决方案，有各自的优缺点，具体如下：

路由转发：路由转发严格意义上不属于微前端，多个子模块之间共享一个导航即可简单，易实现体验不好，切换应用整个页面刷新；
嵌套 iframe：每个子应用一个 iframe 嵌套应用之间自带沙箱隔离重复加载脚本和样式；
构建时组合：独立仓储，独立开发，构建时整体打包，合并应用方便依赖管理，抽取公共模块无法独立部署，技术栈，依赖版本必须统一；
运行时组合：每个子应用独立构建，运行时由主应用负责应用管理，加载，启动，卸载，通信机制良好的体验，真正的独立开发，独立部署复杂，需要设计加载，通信机制，无法做到彻底隔离，需要解决依赖冲突，样式冲突问题；
开源微前端框架也有多种，例如阿里出品的qiankun，icestark，还有针对angular提出的mooa等，都能快速接入项目，但结合公司内部系统的特点，直接采用会有有些限制，例如要实现定制界面，无刷新加载应用，且不能对现有项目的开发和部署造成影响，因此决定自研相关技术。

四、架构设计

4.1 应用层

应用层包括所有接入微服务工作台的内部系统，他们各自开发与部署，接入前后没有多大影响，只是需要针对微服务层单独输出打包一份静态资源；

4.2 微服务层

微服务层作为核心模块，拥有资源加载、路由管理、状态管理和用户认证管理几大功能，具体内容将在后面详细阐述，架构整体工作流程如下：

4.3 基础支撑层

基础支撑层作为基座，提供微服务运行的环境和容器，同时接入其他后端服务，丰富实用场景和业务功能；

五、技术重难点

要实现自定义微前端架构，难点在于需要管理和整合多个应用，确保应用之间独立运行，彼此不受影响，需要解决如下几个问题：

5.1 资源管理

5.1.1资源加载

每个应用有一个应用资源管理和注册的文件(app.regiser.js)，其中包含路由信息，应用配置信息(configs.js)和静态资源清单，当首次切换到某应用时，首先加载app.register.js文件，完成路由和应用信息的注册，然后根据当前浏览器路由地址加载对应的静态文件，完成页面渲染，从而将各应用的静态资源串联起来，其中注册入口文件通过webpack插件来实现，具体实现如下：

FuluAppRegisterPlugin.prototype.apply = function(compiler) {appId = extraAppId();var entry = compiler.options.entry;if (isArray(entry)) {for (var i = 0; i < entry.length; i++) {if (isIndexFile(entry[i])) { // 入口文件indexFileEdit(entry[i]);entry[i] = entry[i].replace(indexEntryRegx, indeEntryTemp); // 替换入口文件i = entry.length;}}} else {if (isIndexFile(entry)) { // 入口文件indexFileEdit(entry); // 重新生成和编辑入口文件compiler.options.entry = compiler.options.entry.replace(indexEntryRegx, indeEntryTemp); // 替换入口文件}}compiler.hooks.done.tap('fulu-app-register-done', function(compilation) {fs.unlinkSync(tempFilePath); // 删除临时文件return compilation;});compiler.hooks.emit.tap('fulu-app-register', function(compilation) {var contentStr = 'window.register("'+ appId + '", {\nrouter: [ \n ' + extraRouters() + ' \n],\nentry: {\n'; // 全局注册方法var entryCssArr = [];var entryJsArr = [];for (var filename in compilation.assets) {if (filename.match(mainCssRegx)) { // 提取css文件entryCssArr.push('\"' + filename + '\"');} else if (filename.match(mainJsRegx) || filename.match(manifestJsRegx) || filename.match(vendorsJsRegx)) { // 提取js文件entryJsArr.push('\"' + filename + '\"');}}contentStr += ('css: ['+ entryCssArr.join(', ') +'],\n'); // css资源清单contentStr += ('js: ['+ entryJsArr.join(', ') +'],\n }\n});\n'); // js资源清单compilation.assets['resources/js/' + appId + '-app-register.js'] = { // 生成appid-app-register.js入口文件source: function() {return contentStr;},size: function() {return contentStr.length;}};return compilation;});};

5.1.2资源文件名

微服务输出打包模式下，静态资源统一打包形式以项目id开头，形如10000092-main.js，
文件名称的修改通过webpack的插件实现；

核心实现代码如下：

FuluAppRegisterPlugin.prototype.apply = function(compiler) {......compiler.options.output.filename = addIdToFileName(compiler.options.output.filename, appId);compiler.options.output.chunkFilename = addIdToFileName(compiler.options.output.chunkFilename, appId);compiler.options.plugins.forEach((c) => {if (c.options) {if (c.options.filename) {c.options.filename = addIdToFileName(c.options.filename, appId);}if (c.options.chunkFilename) {c.options.chunkFilename = addIdToFileName(c.options.chunkFilename, appId);}}});......};

5.2 路由管理

路由分为应用级和菜单级两大类，应用类以应用id为前缀，将各应用区分开，避免路由地址重名的情况，菜单级的路由由各应用的路由系统自行管理，结构如下：

5.3 状态分隔

前端项目通过状态管理库来进行数据的管理，为了保证各应用彼此间独立，因此需要修改状态库的映射关系，这一部分需要借助于webpack插件来进行统一的代码层面调整，包括model和view两部分代码，model定义了状态对象，view借助工具完成状态对象的映射，调整规则为【应用id+旧状态对象名称】，下面来讲解一下插件的实现；

插件的实现原理是借助AST的搜索语法匹配源代码中的状态编写和绑定的相关代码，然后加上应用编号前缀，变成符合预期的AST，最后输出成目标代码：

module.exports = function(source) {var options = loaderUtils.getOptions(this);stuff = 'app' + options.appId;isView = !!~source.indexOf('React.createElement'); // 是否是视图层allFunc = [];var connectFn = "function connect(state) {return Object.keys(state).reduce(function (obj, k) { var nk = k.startsWith('"+stuff+"') ? k.replace('"+stuff+"', '') : k; obj[nk] = state[k]; return obj;}, {});}";connctFnAst = parser.parse(connectFn);const ast = parser.parse(source, { sourceType: "module", plugins: ['dynamicImport'] });traverse(ast, {CallExpression: function(path) {if (path.node.callee && path.node.callee.name === 'connect') { // export default connext(...)if (isArray(path.node.arguments)) {var argNode = path.node.arguments[0];if (argNode.type === 'FunctionExpression') { // connect(() => {...})traverseMatchFunc(argNode);} else if (argNode.type === 'Identifier' && argNode.name !== 'mapStateToProps') { // connect(zk)var temp_node = allFunc.find((fnNode) => {return fnNode.id.name === argNode.name;});if (temp_node) {traverseMatchFunc(temp_node);}}}} else if (path.node.callee && path.node.callee.type === 'SequenceExpression') {if (isArray(path.node.callee.expressions)) {for (var i = 0; i < path.node.callee.expressions.length; i++) {if (path.node.callee.expressions[i].type === 'MemberExpression'&& path.node.callee.expressions[i].object.name === '_dva'&& path.node.callee.expressions[i].property.name === 'connect') {traverseMatchFunc(path.node.arguments[0]);i = path.node.callee.expressions.length;}}}}},FunctionDeclaration: function(path) {if (path.node.id.name === 'mapStateToProps' && path.node.body.type === 'BlockStatement') {traverseMatchFunc(path.node);}allFunc.push(path.node);},ObjectExpression: function(path) {if (isView) {return;}if (isArray(path.node.properties)) {var temp = path.node.properties;for (var i = 0; i < temp.length; i++) {if (temp[i].type === 'ObjectProperty' && temp[i].key.name === 'namespace') {temp[i].value.value = stuff + temp[i].value.value;i = temp.length;}}}}});return core.transformFromAstSync(ast).code;};

5.4 框架容器渲染

完成以上步骤的改造，就可以实现容器中的页面渲染，这一部分涉及到组件库框架层面的调整，大流程如下图：

六、构建流程

6.1 使用插件

构建过程中涉及到两款自开发的插件，分别是fulu-app-register-plugin和fulu-app-loader；

6.1.1 安装

npm i fulu-app-register-plugin fulu-app-loader -D;

6.1.2 配置

webpack配置修改:

const FuluAppRegisterPlugin = require('fulu-app-register-plugin');module: {rules: [{test: /\.jsx?$/,loader: 'fulu-app-loader',}]}plugins: [new FuluAppRegisterPlugin(),......]