iOS端Moodle混合应用白屏：Failed to request allowed query parameters from Webprivacy

问题描述 #

开发基于Cordova、Node、Angular及TypeScript的Moodle混合应用，已完成URL修复、更换Logo等定制化修改。Android真机及模拟器运行正常，但iOS设备每次启动均显示白屏，同时控制台出现警告：Failed to request allowed query parameters from Webprivacy

已尝试的环境组合 #

• Cordova 12 + iOS平台4.1.1/5.1.1 + Node 14.15.0~15（项目要求版本）
• Cordova 12 + iOS平台7.1.1 + Node 18.18.0（package.json指定版本）

已尝试的解决方案 #

• 确认index文件中onDeviceReady函数逻辑编写正确
• 在config.xml中设置AutoHideSplashScreen为true
• 配置了iOS端必要的应用权限

可行解决方案建议 #

1. 检查并修复Cordova白名单配置 #

• 确保安装了与Cordova 12兼容的cordova-plugin-whitelist插件，在config.xml中添加正确的访问规则：

  <!-- 允许访问目标Moodle域名 -->
  <access origin="https://your-moodle-domain.com" />
  <!-- 允许WebView导航到该域名下的所有页面 -->
  <allow-navigation href="https://your-moodle-domain.com/*" />
  

• 如果需要允许特定查询参数，可在allow-navigation标签中通过query属性指定：

  <allow-navigation href="https://your-moodle-domain.com/*" query="token,lang" />
  

2. 确保Angular初始化与Cordova生命周期同步 #

• 修改main.ts，将Angular应用的启动逻辑放在deviceready事件触发后执行，避免WebView未就绪时加载应用：

  import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
  import { AppModule } from './app/app.module';
  
  document.addEventListener('deviceready', () => {
    platformBrowserDynamic().bootstrapModule(AppModule)
      .catch(err => console.error('Angular启动失败:', err));
  }, false);
  

3. 彻底清理并重建iOS项目 #

• 执行以下命令清理旧的平台文件和缓存，重新构建：

  cordova platform remove ios
  cordova platform add ios@[你使用的版本号]
  cordova clean ios
  cordova build ios --prod
  

4. 排查Xcode控制台的详细日志 #

• 用Xcode连接iOS设备，查看完整的控制台输出，除了Webprivacy警告外，是否存在Angular加载失败、资源路径错误、权限缺失等其他异常，这些往往是白屏的直接原因

5. 调整WKWebView的隐私配置 #

• 若使用cordova-plugin-wkwebview-engine，检查插件配置是否允许URL查询参数的传递，可尝试在config.xml中添加：

  <preference name="AllowBackForwardNavigationGestures" value="true" />
  <preference name="AllowLinkPreview" value="true" />
  

  或者针对特定域名放宽WebView的权限限制

内容的提问来源于stack exchange，提问作者NIkhil kolambe