错误处理与 HTTP 状态码
检查响应状态码，并将错误映射为类型化的领域错误。
错误处理与 HTTP 状态码 是 CoddyKit 上的免费 Swift Academy 课时。 这是第 3 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Swift Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Swift Academy 课程共包含 4 节课。
HTTP 状态码范围
HTTP 响应通过状态码表示成功或失败：2xx 表示成功，3xx 表示重定向，4xx 表示客户端错误，5xx 表示服务器错误。
// 200 OK, 201 Created
// 400 Bad Request, 401 Unauthorized, 404 Not Found
// 500 Internal Server Error在 Swift 中检查状态码
将 URLResponse 转换为 HTTPURLResponse，并在异步请求完成后检查 statusCode。
let (data, response) = try await URLSession.shared.data(from: url)
guard let http = response as? HTTPURLResponse else {
throw NetworkError.invalidResponse
}
guard (200..<300).contains(http.statusCode) else {
throw NetworkError.httpError(http.statusCode)
}类型化网络错误
为网络失败定义类型化错误枚举，以便在 catch 代码块中进行穷举处理。
enum NetworkError: Error {
case invalidURL
case invalidResponse
case httpError(Int)
case decodingError(Error)
case noData
}将状态码映射为错误
根据状态码进行分支处理，生成有意义的领域错误，而不是直接使用原始整数。
switch http.statusCode {
case 200..<300: break // success
case 401: throw NetworkError.unauthorized
case 404: throw NetworkError.notFound
case 500..<600: throw NetworkError.serverError(http.statusCode)
default: throw NetworkError.httpError(http.statusCode)
}解码错误响应
状态表示错误时，响应正文通常包含 JSON 格式的错误消息。请将其解码，以获得更好的诊断信息。
if http.statusCode != 200 {
struct APIError: Decodable { var message: String }
let apiError = try? JSONDecoder().decode(APIError.self, from: data)
throw NetworkError.serverMessage(apiError?.message ?? "Unknown error")
}在 async 中传播错误
Swift 的结构化并发会自然地传播错误：某个任务抛出错误后，TaskGroup 中的同级任务会被取消。
async let users = fetchUsers()
async let posts = fetchPosts()
let (u, p) = try await (users, posts) // if either throws, both cancel捕获特定错误
使用类型化的 catch 代码块，在调用代码中分别处理不同种类的错误。
do {
let items = try await fetchItems()
} catch NetworkError.unauthorized {
showLoginScreen()
} catch NetworkError.httpError(let code) {
print("HTTP Error: \(code)")
} catch {
print("Unexpected: \(error)")
}URLError 代码
URLError 描述连接失败：.notConnectedToInternet、.timedOut、.cannotFindHost。
do {
let (data, _) = try await URLSession.shared.data(from: url)
} catch let urlError as URLError where urlError.code == .notConnectedToInternet {
print("No internet connection")
}用于网络请求的 Result 包装器
如果希望调用方无需使用 try/catch 即可处理错误，请让获取函数返回 Result。
func fetchUser() async -> Result<User, NetworkError> {
do {
let user = try await performFetch()
return .success(user)
} catch let e as NetworkError {
return .failure(e)
} catch {
return .failure(.unknown)
}
}错误日志记录
记录包含相关上下文的网络错误（URL、状态码和正文），以便在生产环境中进行调试。
func log(_ error: NetworkError, url: URL) {
print("[Network] \(url.absoluteString) → \(error)")
}面向用户的错误消息
将技术错误映射为用户易于理解的字符串。绝不要在界面中显示原始 HTTP 状态码。
extension NetworkError: LocalizedError {
var errorDescription: String? {
switch self {
case .unauthorized: return "Please log in again."
case .notFound: return "The requested item was not found."
case .serverError: return "Server error. Please try again later."
default: return "Something went wrong."
}
}
}快速检查
哪个 HTTP 状态码范围表示响应成功？
课程回顾
调用 URLSession.data(from:) 后，将结果转换为 HTTPURLResponse 并检查 statusCode。将状态码映射为类型化的 Error 情况。使用 URLError 表示连接失败。使用 try/throw 传播错误，并通过类型化的 catch 代码块捕获错误。
常见问题解答
「错误处理与 HTTP 状态码」课时是免费的吗？
是的 — 「错误处理与 HTTP 状态码」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Swift Academy 课程的其余内容，请升级到 CoddyKit PRO。 Swift Academy 课程共包含 4 节课。
「错误处理与 HTTP 状态码」这节课中我会学到什么？
检查响应状态码，并将错误映射为类型化的领域错误。 你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Swift Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Swift Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 4 节。
「错误处理与 HTTP 状态码」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Swift Academy 课中编写并运行代码吗？
能。每节 Swift Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。