IOS真机调试调用一键登录服务预登录报错：preLogin:fail 未能完成操作。（GeYanSdkDomain错误-20102。）

iOS真机调试一键登录预登录报错，常见原因及解决方案如下：

1. Bundle ID配置问题
   iOS标准基座必须使用io.dcloud.HBuilder重签才能调用一键登录。若使用自定义Bundle ID，需制作自定义基座，否则会触发1004（应用不存在）或30005（预登录失败）。请确认：

   • 真机调试时是否用HBuilder标准基座（Bundle ID固定为io.dcloud.HBuilder）
   • 若用自定义ID，是否已通过离线打包集成一键登录SDK

2. 设备环境限制
   预登录依赖蜂窝网络和有效SIM卡（文档说明）。若手机无SIM卡/蜂窝数据关闭，会导致30005（预登录失败）。后续报错30008（请求冲突）通常因首次预登录未完成就重复调用，需确保：

   • 调用uni.preLogin()前检查网络状态
   • 避免连续快速调用（需等待前次请求完成）

3. 其他排查点

   • 确认一键登录服务已开通且账户余额充足（错误码1002）
   • 检查HBuilderX版本（Alpha 4.86/正式版4.85），升级到最新版
   • 真机调试时关闭VPN，避免运营商网关拦截

安卓正常而iOS异常，大概率是基座配置或设备环境问题。请优先验证Bundle ID与基座匹配性，并确保设备有有效蜂窝网络。详细错误码参考：uni-app错误规范

首次提示信息如下

{  
    "errMsg": "preLogin:fail 未能完成操作。（GeYanSdkDomain错误-20102。）",  
    "code": -20102,  
    "appid": "pPyZ********a10aJ009",  
    "metadata": {},  
    "uid": "gtc_7a8ff********dc1c97c63"  
}

后续都是提示以下信息

{  
    "errMsg": "preLogin:fail -20102appid配置获取错误，请联系技术支持",  
    "code": 30005,  
    "appid": "pPyZWv********PXba10aJ009",  
    "metadata": {},  
    "uid": "gtc_7a8fffe6d9f5**********854334dc1c97c63"  
}

原因找到了，因为使用标准基座后，BundleID会被强制修改为io.dcloud.HBuilder导致跟一键登录服务的BundleID对不上

解决方案：使用自定义基座，保留证书的BundleID