多页表单自动保存的服务端校验实现方案咨询

核心逻辑是采用单源校验规则+按页动态切片校验的架构，既不需要为每个表单页单独维护校验Schema，也不需要等用户全量填完再做校验，同时覆盖你提到的两个现有方案的缺陷。

实现步骤 #

• 抽离全局唯一校验规则源
  不要按页面维度拆分校验规则，将整个表单所有字段的校验规则（格式要求、长度限制、必填规则、自定义校验逻辑）统一维护为一份完整的全局Schema，不管用Mongoose自带的校验规则、还是Zod/Joi这类校验库都可以实现。这份Schema是前后端双侧校验的唯一可信源，前端Flutter侧、后端Express侧都基于这份规则做校验，从根源上避免双侧规则不一致、重复维护的问题。
• 维护轻量页面-字段映射表
  单独维护一份配置表，仅记录每个表单页对应的字段列表即可，不需要包含任何校验逻辑，示例：

  const pageFieldMap = {
    1: ['realName', 'idNumber', 'phone'],
    2: ['companyName', 'position', 'workingYears'],
    // 其余页面按相同格式配置，仅需列字段名
  }
  

• 开发通用单页校验中间件
  后端不需要为每个页面编写独立校验逻辑，只需要写一个可复用的校验中间件，逻辑如下：
  1. 接口收到单页提交请求时，先读取请求携带的页码参数、当前页填写的表单数据
  2. 从页面-字段映射表中取出当前页包含的所有字段名
  3. 从全局校验Schema中，动态抽取当前页对应字段的规则，生成本次请求专用的临时校验Schema
  4. 用临时Schema校验本次提交的单页数据：校验通过则将数据增量写入MongoDB的表单草稿表（以用户ID+表单ID作为唯一键）；校验不通过直接返回对应字段的错误信息，前端当场提示用户修改，不需要进入下一页
     Node侧核心逻辑参考：

  const pageFormValidate = (req, res, next) => {
    const { pageNum, formData } = req.body
    // 获取当前页对应的字段列表
    const currentFields = pageFieldMap[pageNum]
    // 从全局Schema动态生成本页校验规则
    const currentPageSchema = globalFormSchema.pick(
      currentFields.reduce((pickConfig, field) => {
        pickConfig[field] = true
        return pickConfig
      }, {})
    )
    // 执行校验
    const validateResult = currentPageSchema.safeParse(formData)
    if (!validateResult.success) return res.status(400).json({ errors: validateResult.error.format() })
    next()
  }
  

• 最终提交兜底校验
  用户走完所有流程点击最终提交时，再用全局完整Schema对草稿中存储的全量数据做一次兜底校验（覆盖用户跳页、历史草稿版本不兼容、非法请求篡改数据等极端场景），校验通过则将草稿数据转存至正式表单集合；校验不通过则直接定位错误字段所在的页面，引导用户跳转修改即可。

方案优势 #

• 维护成本极低：全表单仅需维护一份校验规则，不存在多套规则重复开发、修改时漏改的问题，新增/调整页面时仅需修改页面-字段映射表，不需要改动核心校验逻辑
• 体验符合要求：单页填写完成点击下一步时即时完成服务端校验，错误当场反馈，不需要用户填完所有内容再回头逐页排查修改
• 扩展性强：后续如果要加字段级的跨页联动校验，只需要在全局Schema中补充对应逻辑，不需要调整单页校验的整体流程

内容的提问来源于stack exchange，提问作者Sidd Mittal