Ionic Capacitor/Xcode编译报错：全局变量pspa_proxymap缺失如何解决

• 该报错几乎都和腾讯系H5支付（微信支付、QQ钱包支付）的适配SDK有关：这类SDK要求运行前必须提前声明全局变量pspa_proxymap，用于存储支付请求的代理映射规则，未提前声明就加载SDK就会触发该错误
• Capacitor原生打包后的WebView资源加载顺序和普通浏览器环境不同：浏览器调试时可能因为你的业务代码加载早于SDK，不会触发报错，但原生编译后SDK加载优先级更高，就会出现找不到变量的问题
• 部分封装好的第三方支付、统计类Capacitor插件内置了该SDK逻辑，但没有默认补全全局变量声明，也会触发该报错

• 方案1（优先推荐）：在项目入口HTML文件（默认路径为src/index.html）的<head>标签最顶部，添加全局变量初始化代码，保证SDK加载前变量已存在：

<script>
// 提前初始化pspa_proxymap全局变量，避免SDK加载时报错
window.pspa_proxymap = window.pspa_proxymap || {};
</script>

添加后执行npx cap sync同步配置，再重新编译应用即可。

• 方案2：如果确认项目没有使用腾讯系H5支付相关功能，可以全局检索项目代码，移除所有pspa相关SDK的引用语句，不加载该SDK就不会触发变量校验报错。
• 方案3：如果报错是引入的第三方Capacitor支付插件导致，可以查看插件官方配置文档，关闭「内置H5支付适配」相关开关，即可避免插件自动加载对应SDK。

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