0Pricing
TypeScript Academy · 课时

错误中间件与结果类型

设计集中式错误处理器和带类型的 Result 模式；包装异步处理器以转发错误；返回格式一致的错误信封。

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

简介

目标：集中处理运行时错误，并返回一致的 JSON“错误封装”。您将创建一个结果类型、一个异步处理程序包装器和一个健壮的错误中间件。

  • 带判别标记的结果<T,E>
  • 异步处理程序中的 next(err)
  • 从未知值到类型化错误的映射

结果类型

使用带判别标记的联合类型表示函数结果：{ ok: true; value } 或 { ok: false; error }。调用方必须处理这两个分支。

// Result pattern for services and controllers
export type Ok<T> = { ok: true; value: T }
export type Err<E> = { ok: false; error: E }
export type Result<T, E = string> = Ok<T> | Err<E>

export const ok = <T>(value: T): Ok<T> => ({ ok: true, value })
export const err = <E>(error: E): Err<E> => ({ ok: false, error })

// Example usage
async function getUserName(id: string): Promise<Result<string, "NOT_FOUND" | "DB">> {
  if (id === "missing") return err("NOT_FOUND")
  try { return ok("Ada") } catch { return err("DB") }
}

错误封装

将未知值规范化为一个小型且可预测的错误封装。避免向客户端泄露堆栈跟踪。

// Canonical error envelope
export type ErrorEnvelope = {
  error: string
  code?: string
  details?: unknown
}

export function mapError(u: unknown): ErrorEnvelope {
  if (u instanceof Error) return { error: u.message }
  if (typeof u === "string") return { error: u }
  try { return { error: JSON.stringify(u) } } catch { return { error: "Unknown error" } }
}

异步包装器与中间件

包装任意异步处理程序，使被拒绝的结果调用 next(err)。最终的错误中间件只格式化一次 JSON。

import express, { Request, Response, NextFunction } from "express"

export const asyncHandler = <P, ResBody, ReqBody, Query>(fn: (req: Request<P, ResBody, ReqBody, Query>, res: Response<ResBody>, next: NextFunction) => Promise<unknown>) => {
  return (req: Request<P, ResBody, ReqBody, Query>, res: Response<ResBody>, next: NextFunction) => {
    Promise.resolve(fn(req, res, next)).catch(next)
  }
}

export function errorMiddleware(err: unknown, _req: Request, res: Response, _next: NextFunction) {
  const env = mapError(err)
  const status = env.code === "NOT_FOUND" ? 404 : 500
  res.status(status).json(env)
}

// Usage
// app.get("/", asyncHandler(async (req, res) => { throw new Error("boom") }))
// app.use(errorMiddleware)

路由与集成

将验证与错误处理结合起来：验证失败时返回带详细信息的 400 响应；其他拒绝由中央中间件捕获。

import express from "express"
import { z } from "zod"
import { asyncHandler, errorMiddleware } from "./errors"

const createUserSchema = z.object({ name: z.string().min(1) })

const app = express()
app.use(express.json())

app.post("/users", asyncHandler(async (req, res) => {
  const parsed = createUserSchema.safeParse(req.body)
  if (!parsed.success) {
    res.status(400).json({ error: "Invalid body", details: parsed.error.format() })
    return
  }
  res.status(201).json({ id: "u_1", name: parsed.data.name })
}))

app.use(errorMiddleware)

app.listen(3000, () => console.log("http://localhost:3000"))

提示

提示：

  • 记录服务器端详细信息，只向客户端返回最少的信息。
  • 在服务中优先使用带类型的结果，并在边界处映射为 HTTP 响应。
  • 绝不要吞掉拒绝结果——始终调用 next(err)。

异步错误检查

快速检查：哪种模式能够正确转发异步错误？

回顾

回顾：在领域逻辑中使用结果联合类型，包装异步处理程序以调用 next，并在最终中间件中只格式化一次错误。

常见问题解答

「错误中间件与结果类型」课时是免费的吗？

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

「错误中间件与结果类型」这节课中我会学到什么？

设计集中式错误处理器和带类型的 Result 模式；包装异步处理器以转发错误；返回格式一致的错误信封。 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 TypeScript Academy 需要有经验吗？

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

「错误中间件与结果类型」课时需要多长时间？

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

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

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

此课程中的所有课时

  1. 路由处理器、Request/Response 类型
  2. 使用 zod 进行模式校验并推断 TS 类型
  3. 错误中间件与结果类型
← 返回 TypeScript Academy