JavaScript / TypeScript / 系统课时

编写类型安全的业务逻辑

编写类型安全的业务逻辑

业务逻辑最怕“状态能写出来,但实际上不允许发生”。本节用订单支付示例把判别联合、泛型结果类型和工具类型组合起来,让非法状态更难表达,并让新增状态时的遗漏尽量在编译阶段暴露。

学习目标

  • 用判别联合表达互斥的业务状态和状态专属字段
  • 用泛型封装可复用的成功、失败结果处理
  • 使用 Pick 与 Readonly 缩小下游可见数据和修改权限

用判别联合表达业务状态

不要把订单写成一个拥有大量可选字段的接口,例如同时允许 paidAt?、reason? 和任意 status。这种模型会允许“已取消但同时存在付款时间”之类的无效组合。

判别联合会把 status 作为唯一判别字段:pending、paid、cancelled 各自只携带当前状态合法的数据。进入 switch 后,TypeScript 会根据分支自动收窄对象类型,因此业务规则可以直接绑定到状态。

组合泛型结果与工具类型

下面的示例实现“待支付订单才能支付”,再把成功结果映射成只读摘要。三个类型工具各有不同职责:判别联合限制状态,Result<T> 复用成功/失败结构,Pick 与 Readonly 控制输出面。

ts
type OrderBase = {
  id: string;
  total: number;
};

// status 是判别字段,每个状态只携带该状态合法的数据。
type Order =
  | (OrderBase & { status: "pending" })
  | (OrderBase & { status: "paid"; paidAt: string })
  | (OrderBase & { status: "cancelled"; reason: string });

type Result<T> =
  | { ok: true; value: T }
  | { ok: false; error: string };

// 摘要只暴露必要字段,并禁止下游直接修改。
type OrderSummary = Readonly<
  Pick<OrderBase, "id" | "total"> & { status: Order["status"] }
>;

function assertNever(value: never): never {
  throw new Error(`未处理的订单状态: ${JSON.stringify(value)}`);
}

function pay(order: Order): Result<Order> {
  switch (order.status) {
    case "pending":
      return {
        ok: true,
        value: {
          ...order,
          status: "paid",
          paidAt: "2026-09-01T12:00:00Z",
        },
      };
    case "paid":
      return { ok: false, error: "订单已支付" };
    case "cancelled":
      return { ok: false, error: "已取消订单不能支付" };
    default:
      return assertNever(order);
  }
}

// 泛型映射只转换成功值,失败分支原样传播。
function mapResult<T, U>(result: Result<T>, fn: (value: T) => U): Result<U> {
  return result.ok ? { ok: true, value: fn(result.value) } : result;
}

function toSummary(order: Order): OrderSummary {
  return { id: order.id, total: order.total, status: order.status };
}

const initial: Order = { id: "A1001", total: 199, status: "pending" };
const summaryResult = mapResult(pay(initial), toSummary);

if (summaryResult.ok) {
  console.log(
    `${summaryResult.value.id} ${summaryResult.value.status} ¥${summaryResult.value.total}`,
  );
} else {
  console.log(`支付失败: ${summaryResult.error}`);
}

预期输出

text
A1001 paid ¥199

这里没有使用类型断言。pay 只能根据已经收窄的订单状态产生结果;mapResult 不关心订单细节,因此可以复用于其他 Result<T>;摘要类型则限制调用方只能看到 id、total 和 status。

让新增状态暴露遗漏

assertNever 是这段逻辑的重要保险。如果以后给 Order 增加 refunded 状态,却忘记在 pay 的 switch 中处理它,那么 default 分支里的 order 将不再是 never,编译器会直接报错。这比运行后才发现某个新状态落入错误分支更可靠。

工具类型也应服务于边界,而不是为了“类型技巧”而堆叠。Pick 适合限制 DTO 或视图模型字段;Readonly 适合表达下游只读数据;Partial 更适合补丁输入,而不应把核心业务实体整体变成可选字段。业务模型越接近真实约束,后续函数就越少依赖额外判空和防御性判断。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

编写类型安全的业务逻辑

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通