uniapp使用vue3打包H5，android或ios加载白屏

最新推荐文章于 2025-08-26 18:28:25 发布

原创最新推荐文章于 2025-08-26 18:28:25 发布 · 2.4k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#uni-app #android

在使用uniapp结合Vue3创建项目并执行npm run build:h5后，通过Android或iOS的webview加载会遇到白屏问题。原因在于跨域限制，Android Studio日志显示CORS政策阻止了文件访问。解决方案是针对webview添加允许所有源的CORS设置，调整后应用能正常打开。经测试，Vue2的项目打包未出现此问题，推测可能由Vue3的打包配置变动引起。

前景介绍

按照uniapp官方文档介绍，根据步骤创建了使用Vue3的项目；执行命令npm run build:h5,

本地安装了http-server，打包之后的dist文件夹，执行http-server后，可以访问；

但是使用Android或者ios进行本地加载白屏；以Android为例子，将打包后的文件夹存放到asset文件夹下，使用webview的loadUrl加载；

 val webView = findViewById<WebView>(R.id.webview)
 val webSettings = webView.settings
 webSettings.javaScriptEnabled = true
 webSettings.allowFileAccess = true
 webSettings.allowContentAccess = true
 webSettings.domStorageEnabled = true
 // 加载本地 HTML 文件
 val htmlFile = "file:///android_asset/plugin_m1010_01/index.html#pages/index/index" 
// 确保 HTML 文件在 assets 文件夹中
 webView.loadUrl(htmlFile)

但是调试发现，白屏；查看android-studio发现了如下问题

uniapp Access to script at 'file:///android_asset/assets/index-WZlAV6YJ.js' from origin 'null' has been blocked by CORS policy: Cross origin requests are only supported for protocol 。。。。。。

大致意思就是跨域了；按照网上的教程加了一行代码

webSettings.setAllowUniversalAccessFromFileURLs(true);

重新debug调试，可以正常打开了；

PS：亲测了一下，使用vue2的项目打包成h5，是没有这个问题的；应该是vue3的打包改动引起的；