使用 qiankun 集成应用时，出现的部分错误及解决方案

以你之姓@ 2024-04-06 13:36 142阅读 0赞

[常见问题 - qiankun][- qiankun]

1. \[import-html-entry\]: error occurs while executing entry script

2. 在子应用中，监听浏览器窗口变化

3. 手动加载微应用报错 single-spa minified message \#31，see ...

4. 打包微前端项目后，激活不了微应用，也不报错

5. 缺少生命周期 you need to export lifecycle functions in qiankun-vue entry

6. 目标容器不存在 Target container with \#mico-app not existed after qiankun-vue mounted

7. 微前端跨域问题 Access to fetch at 'http://...' from origin 'http://...' has been blocked by CORS policy

## 1. \[import-html-entry\]: error occurs while executing entry script ##

出现报错的场景：

子应用使用 CND 的方式引用依赖时，集成到基座应用中报错

![db224ad58e3a6ea92723dda23c61580e.png][]

所有的这种报错第一句都是，但这仅仅是提示报错位置，第二句才是真正的错误

`[import-html-entry]: error occurs while executing entry script`

解决方案：

子应用的 script 标签加上 ignore 属性

![image.png][]

## 2. 在子应用中，监听浏览器窗口变化 ##

window.proxy 中，有个方法 —— addEventListener，可以用 原生js 监听窗口变化

(window as any).proxy.addEventListener('resize', () => \{  
console.log('用 原生js 监听窗口变化');  
\});

## 3. 手动加载微应用报错 single-spa minified message \#31，see ... ##

![watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBATHlyZWxpb24_size_20_color_FFFFFF_t_70_g_se_x_16][]

出现报错的场景：

手动加载微应用后，未进行卸载，就切换路由；再次调手动加载微应用后就会报错，微应用出不来了

解决方案：

页面离开前，卸载微应用

onBeforeUnmount(() => \{  
state.microApp.unmount(); // state.microApp 为微应用实例  
\});

## 4. 打包微前端项目后，激活不了微应用，也不报错 ##

分析原因：

如果主应用和微应用在不同的文件夹中，且使用 hash 模式；

直接写 activeRule: '\#/vue' 就会不生效，导致微应用激活不了；

解决方案：

将 activeRule 改为以下写法

const getActiveRule = (hash) => (location) => location.hash.startsWith(hash);  
registerMicroApps(\[  
\{  
name: 'app-hash',  
entry: 'http://localhost:8080',  
container: '\#container',  
activeRule: getActiveRule('\#/vue'),  
\},  
\]);

## 5. 缺少生命周期 you need to export lifecycle functions in qiankun-vue entry ##

![watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBATHlyZWxpb24_size_20_color_FFFFFF_t_70_g_se_x_16 1][]

解决方案：

在 入口文件 增加 qiankun 的生命周期函数

// 生命周期  
export async function bootstrap(): Promise<void> \{  
console.log('\[vue\] vue app bootstraped');  
\}  
  
export async function mount(props: \{ \[keys: string\]: any; \} | undefined): Promise<void> \{  
console.log('\[vue\] props from main framework', props);  
render(props);  
\}  
  
export async function unmount(): Promise<void> \{  
console.log('我离开啦');  
instance.unmount();  
instance.\_container.innerHTML = '';  
instance = null;  
\}

## 6. 目标容器不存在 Target [container][] with \#mico-app not existed after qiankun-vue mounted ##

![watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBATHlyZWxpb24_size_20_color_FFFFFF_t_70_g_se_x_16 2][]

存放微应用的容器不存在，检查代码

**7. 微前端跨域问题 Access to fetch at 'http://...' from origin 'http://...' has been blocked by CORS policy**

![watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBATHlyZWxpb24_size_20_color_FFFFFF_t_70_g_se_x_16 3][]

解决方案：

① 如果是 vue 项目，在 vue.config.js 中，增加允许跨域的配置

module.exports = \{  
devServer: \{  
// 配置跨域请求头，解决开发环境的跨域问题  
headers: \{  
'Access-Control-Allow-Origin': '\*', // 允许所有域名的脚本访问该资源  
\},  
\},  
\}

② 如果是 [react][] 项目，在 .rescriptsrc.js 中，增加允许跨域的配置

module.exports = \{  
devServer: (\_) => \{  
const config = \_;  
  
config.headers = \{  
'Access-Control-Allow-Origin': '\*',  
\};  
config.historyApiFallback = true;  
config.hot = false;  
config.watchContentBase = false;  
config.liveReload = false;  
  
return config;  
\},  
\};

[- qiankun]: https://qiankun.umijs.org/zh/faq
[db224ad58e3a6ea92723dda23c61580e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/76bd8861d6924bd5b176f9b069fe2627.png
[image.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/92234e8a67d64b5f93645e4cdd2d5670.png
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBATHlyZWxpb24_size_20_color_FFFFFF_t_70_g_se_x_16]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/aafd324c840d4f6cb56b651d56702595.png
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBATHlyZWxpb24_size_20_color_FFFFFF_t_70_g_se_x_16 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/88ef0011dd06420daaecfb09580c93bc.png
[container]: https://so.csdn.net/so/search?q=container&spm=1001.2101.3001.7020
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBATHlyZWxpb24_size_20_color_FFFFFF_t_70_g_se_x_16 2]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/b15807765bc34b4391ce9ab8851db97d.png
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBATHlyZWxpb24_size_20_color_FFFFFF_t_70_g_se_x_16 3]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/3e9be4592f104d71bb84001e84a70f31.png
[react]: https://so.csdn.net/so/search?q=react&spm=1001.2101.3001.7020