为何在Start()中执行yield return null会出现协程异常？

问题描述 #

这个问题并非必现，但出现后很难排查：

• 把test()协程放在Start()里启动时，只会输出第一条"a"日志，后面的"b"完全不打印，协程直接卡在yield return null这一步
• 但在Update()里按回车键启动同一个协程时，9次循环的"a"和"b"都能正常输出，协程从头到尾执行完全没问题

原业务场景中，每个管理器的Loading()方法都包含yield return null，有时候所有管理器能正常加载，有时候就会卡在这个语句上。

测试代码 #

void Start()
{
    StartCoroutine(test());
}

IEnumerator test()
{
    LoadingBar.maxValue = 1.0f;
    // 原始业务代码
    //foreach (var v in Loader)
    //{
    //    Debug.Log(v.Key);
    //    yield return v.Value.Loading();
    //    LoadingBar.value = TotalLoadingProgress;
    //}
    // 简化后的测试代码
    for (int i = 0; i < 9; i++)
    {
        Debug.Log("a");// 仅Start启动时会输出这条
        yield return null;
        Debug.Log("b");// Start启动时完全不输出
    }

    OnLoadingCompleted?.Invoke();
}

private void Update()
{
    if (Input.GetKeyDown(KeyCode.Return))
        StartCoroutine(test());
}

原因分析与解决方案 #

核心原因 #

Unity的协程调度器在Start()执行的第一帧可能还未完成完全初始化，或者当前帧的协程调度队列存在异常状态，导致yield return null后，协程无法被正常调度到下一帧继续执行。而Update()是在正常的帧循环流程中触发，此时调度器状态稳定，协程能按预期被唤醒执行。

解决办法 #

1. 延迟一帧启动协程
   在Start()里先等待一帧，再启动目标协程，确保进入正常帧循环后再执行逻辑：

   void Start()
   {
       StartCoroutine(DelayStartTest());
   }
   
   IEnumerator DelayStartTest()
   {
       yield return null; // 等一帧再启动
       StartCoroutine(test());
   }
   

2. 检查对象激活状态
   确认启动协程的GameObject在Start()执行时处于激活状态，避免因对象激活时机异常导致协程调度失败。

3. 替换协程实现（备选）
   如果延迟启动仍无法解决问题，可以考虑用Update()手动驱动加载逻辑，或者使用异步回调替代协程，绕过Unity协程调度器的潜在问题。

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