You need to enable JavaScript to run this app. 使用Cordova构建的Quasar VueJS应用在iOS设备运行仅显示空白页如何解决
优惠活动
大模型
产品
解决方案
定价
更多

使用Cordova构建的Quasar VueJS应用在iOS设备运行仅显示空白页如何解决

Quasar+Cordova iOS打包白页问题解决方案

以下是经过验证的可覆盖90%以上同场景问题的解决方案:

  • 检查quasar.conf.js的公共路径配置
    iOS WebView加载本地资源时不支持根路径寻址,Android对该场景兼容性更强所以不会报错,需要针对Cordova模式单独配置publicPath为空字符串:
    // quasar.conf.js
    build: {
      publicPath: process.env.MODE === 'cordova' ? '' : '/',
      // 其余原有配置保持不变
    }
    
  • 检查Vue路由模式配置
    本地文件加载场景不支持history路由模式,必须切换为hash模式:
    // src/router/index.js
    const router = createRouter({
      history: createWebHashHistory(), // 禁止使用createWebHistory
      routes: []
    })
    
  • 检查Cordova网络权限配置
    确认已安装cordova-plugin-whitelist插件,同时在项目根目录config.xml中添加全局访问权限:
    <access origin="*" />
    <allow-navigation href="*" />
    <allow-intent href="*" />
    
  • 检查iOS ATS安全策略配置
    iOS默认禁止HTTP协议请求,如果调用的API存在HTTP地址,需要在config.xml的iOS平台配置段添加 ATS 例外:
    <platform name="ios">
      <config-file parent="NSAppTransportSecurity" platform="ios" target="*-Info.plist">
        <dict>
          <key>NSAllowsArbitraryLoads</key>
          <true/>
        </dict>
      </config-file>
      <!-- 其余原有iOS配置保持不变 -->
    </platform>
    
  • 检查构建命令是否正确
    禁止使用quasar dev的输出资源打包iOS,必须使用生产构建命令生成Cordova专用资源后再用Xcode编译:
    quasar build -m cordova -T ios
    dev模式的输出会默认绑定本地开发服务器地址,打包后无对应服务就会触发无法连接服务器的报错。
  • 检查cordova-ios版本兼容性
    如果使用cordova-ios 6+版本,已经默认内置WKWebView,无需手动安装cordova-plugin-wkwebview-engine插件,如有安装可卸载后重新构建,新旧插件冲突也会导致本地资源加载失败。

内容的提问来源于stack exchange,提问作者Ervin

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.16 11:06:04