JavaScript / TypeScript / 系统课时
编写类型安全的业务逻辑
编写类型安全的业务逻辑
业务逻辑最怕“状态能写出来,但实际上不允许发生”。本节用订单支付示例把判别联合、泛型结果类型和工具类型组合起来,让非法状态更难表达,并让新增状态时的遗漏尽量在编译阶段暴露。
学习目标
- 用判别联合表达互斥的业务状态和状态专属字段
- 用泛型封装可复用的成功、失败结果处理
- 使用
Pick与Readonly缩小下游可见数据和修改权限
用判别联合表达业务状态
不要把订单写成一个拥有大量可选字段的接口,例如同时允许 paidAt?、reason? 和任意 status。这种模型会允许“已取消但同时存在付款时间”之类的无效组合。
判别联合会把 status 作为唯一判别字段:pending、paid、cancelled 各自只携带当前状态合法的数据。进入 switch 后,TypeScript 会根据分支自动收窄对象类型,因此业务规则可以直接绑定到状态。
组合泛型结果与工具类型
下面的示例实现“待支付订单才能支付”,再把成功结果映射成只读摘要。三个类型工具各有不同职责:判别联合限制状态,Result<T> 复用成功/失败结构,Pick 与 Readonly 控制输出面。
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}`);
}预期输出
A1001 paid ¥199这里没有使用类型断言。pay 只能根据已经收窄的订单状态产生结果;mapResult 不关心订单细节,因此可以复用于其他 Result<T>;摘要类型则限制调用方只能看到 id、total 和 status。
让新增状态暴露遗漏
assertNever 是这段逻辑的重要保险。如果以后给 Order 增加 refunded 状态,却忘记在 pay 的 switch 中处理它,那么 default 分支里的 order 将不再是 never,编译器会直接报错。这比运行后才发现某个新状态落入错误分支更可靠。
工具类型也应服务于边界,而不是为了“类型技巧”而堆叠。Pick 适合限制 DTO 或视图模型字段;Readonly 适合表达下游只读数据;Partial 更适合补丁输入,而不应把核心业务实体整体变成可选字段。业务模型越接近真实约束,后续函数就越少依赖额外判空和防御性判断。