Valibot 项目中日期验证在云服务 Workers 环境下的特殊处理

问题背景

在使用 Valibot 进行表单验证时，开发者在处理日期验证时遇到了一个特殊问题。当尝试在云服务 Workers 环境下使用动态生成的日期作为验证规则时，验证逻辑在本地开发环境工作正常，但在部署到云服务后却出现了异常。

原始方案分析

开发者最初采用了以下验证方案：

export const BirthdateSchema = object({
  birthdate: coerce(
    string([
      minLength(8),
      isoDate(),
      minValue("1900-01-01"),
      maxValue(
        `${String(new Date().getFullYear() - 5)}-01-01`
      ),
    ]),
    toISO as any
  ),
});

这个方案中，maxValue 使用了动态生成的日期，通过 new Date().getFullYear() - 5 计算出一个五年前的年份作为最大允许日期。

问题原因

在云服务 Workers 环境下，直接使用 new Date() 获取当前日期会出现问题。这是因为云服务 Workers 的特殊运行时环境对日期对象的处理与常规浏览器或Node.js环境有所不同。具体表现为：

1. 在 Workers 中同步获取的日期可能不正确
2. 需要将日期操作放在异步函数中执行才能获得准确结果

解决方案

Valibot 的维护者提供了两种改进方案：

方案一：简化验证逻辑

export const BirthdateSchema = v.object({
  birthdate: v.string([
    v.minLength(8),
    v.toCustom((d) => d.replace(/(\d{4})(\d{2})(\d{2})/u, '$1-$2-$3')),
    v.isoDate(),
    v.minValue('1900-01-01'),
    v.maxValue(`${new Date().getFullYear() - 5}-01-01`),
  ]),
});

这个方案简化了验证逻辑，移除了不必要的 coerce 转换，直接使用字符串操作处理日期格式。

方案二：使用异步验证

对于云服务 Workers 环境，更可靠的方案是使用 Valibot 的异步验证功能：

export const BirthdateSchema = v.object({
  birthdate: v.string([
    v.minLength(8),
    v.toCustom((d) => d.replace(/(\d{4})(\d{2})(\d{2})/u, '$1-$2-$3')),
    v.isoDate(),
    v.minValue('1900-01-01'),
    v.customAsync(async () => {
      const year = (await getCurrentDate()).getFullYear() - 5;
      return v.maxValue(`${year}-01-01`);
    }),
  ]),
});

其中 getCurrentDate 是一个在云服务 Workers 中正确获取当前日期的异步函数。

最佳实践建议

1. 环境兼容性：在编写跨环境运行的验证逻辑时，特别是涉及日期操作时，要考虑不同运行时的差异。

2. 输入处理：确保对输入数据进行适当的格式转换和清理，使用 toCustom 方法比强制类型转换更安全。

3. 异步优先：在不确定运行环境的情况下，优先考虑使用异步验证方案，特别是在 Serverless 或边缘计算环境中。

4. 边界值测试：对日期验证逻辑进行充分的边界测试，包括最小日期、最大日期和格式转换。

总结

Valibot 提供了灵活的验证方案来解决不同环境下的日期验证问题。在云服务 Workers 这类特殊环境中，开发者需要注意日期操作的同步/异步差异，合理选择验证策略。通过使用 customAsync 和适当的环境适配代码，可以确保验证逻辑在各种环境下都能可靠工作。