XAPI在Unity编辑器正常可用，安卓端运行打包APK时通信失败易冻结

问题基本表现 #

• 项目在Unity编辑器内运行时，xAPI通信链路完全正常，可成功将指定信息发送至对应数据库并完成展示，经过交叉验证可确认xAPI接入的账号、密钥等凭证配置完全正确。
• 项目打包生成APK安装到移动设备运行后，无法正常完成信息发送流程，多次触发Statement发送操作时，应用会出现冻结、卡死无响应的情况。
• 开发全程参照公开的xAPI接入教程完成功能开发，测试阶段开发用电脑、移动测试设备均不与部署的LRS服务处于同一局域网环境。
• 当前使用的Statement发送核心代码如下：

void SendStatement_key(string verb_key , string actor_key, string definition_key)
{
    //Build out Actor details
    Agent actor = new Agent();
    actor.mbox = "mailto:"+ actor_key.Replace(" ", "")+"@learninglocker.net";
    actor.name = actor_key;

    //Build out Verb details
    Verb verb = new Verb();
    verb.id = new Uri("http://www.example.com/" + verb_key);
    verb.display = new LanguageMap();
    verb.display.Add("en-US", verb_key);

    //Build out Activity details
    Activity activity = new Activity();
    activity.id = new Uri("http://www.example.com/" + definition_key.Replace(" ", ""));

    //Build out Activity Definition details
    ActivityDefinition activityDefinition = new ActivityDefinition();
    activityDefinition.description = new LanguageMap();
    activityDefinition.name = new LanguageMap();
    activityDefinition.name.Add("en-US", (definition_key));
    activity.definition = activityDefinition;

    Result result = new Result();
    Score score = new Score();

    score.raw = _value;
    result.score = score;

    //Build out full Statement details
    Statement statement = new Statement();
    statement.actor = actor;
    statement.verb = verb;
    statement.target = activity;
    statement.result = result;

    //Send the statement
    StatementLRSResponse lrsResponse = lrs.SaveStatement(statement);
    if (lrsResponse.success) //Success
    {
        Debug.Log("Save statement: " + lrsResponse.content.id);
    }
    else //Failure
    {
        Debug.Log("Statement Failed: " + lrsResponse.errMsg);
    }
}

核心故障原因 #

• 代码中调用的lrs.SaveStatement()为同步阻塞式网络请求方法，该方法会在调用线程上持续等待LRS服务器的响应返回，期间阻塞当前线程的所有后续逻辑执行。
• Unity编辑器对同步网络请求做了特殊的平台兼容处理，即使出现请求超时、网络不通的情况，也不会阻塞主线程运行；但安卓等移动端平台的网络实现逻辑与编辑器存在本质差异：
  • 当移动设备网络连通性差、跨域访问受限、LRS服务器响应超时、请求被系统拦截时，同步网络请求会一直处于挂起等待状态，直接卡死承载游戏全量逻辑的Unity主线程，最终造成应用冻结无响应。
• 该类故障与xAPI接入凭证配置无直接关联，属于跨平台网络调用的实现差异引发的问题。

针对性修复方案 #

• 将同步网络调用替换为异步非阻塞实现
  • 把原代码中的同步调用逻辑，替换为xAPI客户端提供的SaveStatementAsync异步接口，配合回调逻辑处理请求返回的成功/失败结果，从根源上避免网络请求阻塞Unity主线程。
• 完成移动端基础网络配置校验
  • 确认安卓Manifest配置文件中已开启INTERNET、ACCESS_NETWORK_STATE基础权限，避免因缺少系统权限导致网络请求被拦截、永久挂起。
  • 在Unity项目的Player Settings中，将安卓平台的“Internet Access”选项设置为“Require”，避免默认的沙箱规则拦截应用发起的外部网络请求。
• 增加请求超时兜底机制
  • 为所有xAPI网络请求设置合理的超时阈值（推荐10s-15s），超时后主动中断请求并输出对应错误日志，避免无期限等待造成的应用卡死。
• 优化移动端调试日志维度
  • 在原有成功/失败判断逻辑基础上，补充输出请求对应的HTTP状态码、设备当前网络可达性、超时触发节点等信息，解决移动端调试时日志信息不足、定位困难的问题。

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