为什么Unity WebGL中await Task.Delay(10)会导致程序执行停止？

DevOps 小满

2026-9-28

问题根因

Unity WebGL 构建目标基于浏览器的单线程 JavaScript 运行时，不支持多线程调度，Task.Delay 依赖 .NET 线程池的定时器回调逻辑，在 WebGL 环境下无法正常触发回调，会导致异步流程永久挂起。

解决方案

方案1：使用UniTask异步库（推荐）

UniTask是专门为Unity优化的异步实现，完美适配WebGL平台，替换成本极低：

导入UniTask库到项目中
将代码中的await Task.Delay(10);替换为await UniTask.Delay(10);即可，其余逻辑无需修改

修改后的代码示例：

while (XAxiscurrentXpos <= -izvalue) 
{ 
    await UniTask.Delay(10); 

    XAxiscurrentXpos += 0.001f;
    Vector3 posx = new Vector3(XAxiscurrentXpos, XAxisposition.y, XAxisposition.z);
    XAxis.transform.localPosition = posx;
}

方案2：使用Unity原生协程（无第三方依赖）

如果不想引入第三方库，可以将这段逻辑改写为协程实现：

// 调用处启动协程
StartCoroutine(MoveXAxisCoroutine());

IEnumerator MoveXAxisCoroutine()
{
    while (XAxiscurrentXpos <= -izvalue) 
    { 
        // 10ms对应0.01秒，使用WaitForSecondsRealtime不受时间缩放影响
        yield return new WaitForSecondsRealtime(0.01f);

        XAxiscurrentXpos += 0.001f;
        Vector3 posx = new Vector3(XAxiscurrentXpos, XAxisposition.y, XAxisposition.z);
        XAxis.transform.localPosition = posx;
    }
}