Zod项目中z.coerce.number()的非空处理技巧

在Zod类型校验库的使用过程中，开发者经常会遇到需要将输入值强制转换为数字类型的需求。z.coerce.number()方法虽然能够很好地处理这种转换，但默认情况下它允许null值通过验证，这在某些业务场景下可能不符合预期。

问题背景

Zod库提供了z.coerce.number()方法，它能够将字符串形式的数字自动转换为Number类型。例如，当从URL路径参数或表单提交中获取数据时，这个方法非常有用，因为HTTP请求中的参数通常都是以字符串形式传输的。

然而，开发者stevenliebregt发现，使用z.coerce.number()时，即使输入为null，校验也会通过。这在需要严格确保数字字段不为空的场景下会带来问题。

解决方案

Zod核心贡献者JacobWeisenburger提供了一个巧妙的解决方案：通过组合使用.number()、.or()和.pipe()方法，既能保持强制类型转换的功能，又能确保字段不为空。

具体实现如下：

const schema = z.number().or(z.string()).pipe(z.coerce.number());

这个方案的工作原理是：

1. 首先允许输入为数字或字符串类型
2. 然后通过管道将这两种类型都强制转换为数字
3. 由于没有显式允许null值，所以null输入会被拒绝

实际应用中的考量

虽然上述方案在纯Zod环境下工作良好，但在与其他库（如@ts-rest/open-api）集成时可能会遇到兼容性问题。特别是当需要自动生成OpenAPI/Swagger文档时，这种组合类型可能会导致文档生成不完整。

对于这种情况，开发者需要考虑：

1. 是否可以在文档生成层面对这种类型进行特殊处理
2. 是否需要在业务逻辑层添加额外的非空校验
3. 是否可以接受在文档中类型定义不够精确的妥协

最佳实践建议

根据实际项目经验，在处理数字类型的强制转换和非空校验时，建议：

1. 对于简单的API接口，可以直接使用z.coerce.number().nonnullable()
2. 对于需要与文档生成工具集成的场景，可能需要创建自定义的类型转换器
3. 在关键业务逻辑处，即使使用了类型校验，也应添加额外的业务逻辑校验
4. 考虑创建可复用的数字校验工具函数，统一处理各种边界情况

Zod的强大之处在于它的组合性和灵活性，开发者可以根据具体需求选择最适合的解决方案。理解每种方法的优缺点，才能在实际项目中做出合理的选择。