Swift Academy · 课时

try await 与错误传播

将 try await 用于会抛出错误的异步函数，使用 do/catch 处理失败，并将错误清晰地向上传播（包括 CancellationError ）。

第 3 / 3 课8 个步骤

try await 与错误传播 是 CoddyKit 上的免费 Swift Academy 课时。这是第 3 节课，共 3 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Swift Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Swift Academy 课程共包含 3 节课。

为什么使用尝试等待？

尝试等待会调用可抛出错误的异步函数。如果函数抛出错误，错误会向上传播，除非您捕获它。您也可以使用可选失败处理将结果转换为可选值。

可抛出错误的异步函数与处理

创建一个可抛出错误的异步函数，并在do/catch中使用尝试等待调用它，以处理失败情况。

enum NetError: Error { case offline; case badStatus(Int) }

func fetchNumber(from ok: Bool) async throws -> Int {
    try await Task.sleep(nanoseconds: 100_000_000)
    if !ok { throw NetError.offline }
    return 7
}

Task {
    do {
        let n = try await fetchNumber(from: true)
        print("value:", n)          // 7
    } catch {
        print("failed:", error)     // handled here
    }
}

转换错误

使用可选失败处理获取可选值，而不是抛出错误。除非您确定不可能失败，否则请避免使用强制尝试。

Task {
    // try? converts failure to nil
    let maybe = try? await fetchNumber(from: false)
    print("optional result:", String(describing: maybe)) // nil on error

    // ⚠️ try! will crash if an error is thrown — avoid in production
    // let forced = try! await fetchNumber(from: false)
}

向上传播错误

将调用方标记为异步且可抛出错误，以便将错误向上传播；错误可以在更高层边界处处理。

func loadProfile(ok: Bool) async throws -> String {
    let id = try await fetchNumber(from: ok)   // propagate on error
    return "id:\\(id)"
}

Task {
    do {
        let s = try await loadProfile(ok: true)
        print(s) // "id:7"
    } catch {
        print("propagated:", error)
    }
}

针对性捕获

使用模式匹配的捕获代码块。先处理CancellationError，让关闭路径快速且安静。

enum FileError: Error { case notFound }

func mightCancel() async throws {
    for _ in 0..<5 {
        try Task.checkCancellation()                 // throws CancellationError
        try await Task.sleep(nanoseconds: 30_000_000)
    }
}

Task {
    let t = Task { try await mightCancel() }
    t.cancel()
    do {
        try await t.value
    } catch is CancellationError {
        print("cancelled cleanly")                   // handle cancellation separately
    } catch {
        print("other error:", error)
    }
}

使用尝试等待处理错误

提示：

使用尝试传播错误，直到到达能够做出决定的边界（用户界面、CLI 或顶层任务）。
优先使用领域错误（枚举）以提升清晰度。
只有在缺少结果可以接受时，才使用可选失败处理进行转换。
单独捕获CancellationError。

使用尝试等待处理错误

快速检查：try await f()如何处理错误？

在交互式课程中回答

回顾

回顾：对可抛出错误的异步函数使用尝试等待，从辅助函数向上传播错误，在可选结果足够时使用可选失败处理进行转换，并显式捕获CancellationError。

免费开始

用 AI 导师学习 Swift — 免费

在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。

课程: 122
课程: 409

免费开始学习查看完整课程

常见问题解答

「try await 与错误传播」课时是免费的吗？

是的 — 「try await 与错误传播」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Swift Academy 课程的其余内容，请升级到 CoddyKit PRO。 Swift Academy 课程共包含 3 节课。

「try await 与错误传播」这节课中我会学到什么？

将 try await 用于会抛出错误的异步函数，使用 do/catch 处理失败，并将错误清晰地向上传播（包括 CancellationError ）。你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Swift Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Swift Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 3 节课，共 3 节。

「try await 与错误传播」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Swift Academy 课中编写并运行代码吗？

能。每节 Swift Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Swift Academy