Express + TypeScript 集成 async-validator 实现前后端统一数据校验

ArcGIS实战:地形湿度指数(TWI)计算全流程解析 本文详细解析了ArcGIS中地形湿度指数(TWI)的计算全流程,从DEM数据获取、填洼处理到水流方向与汇流累积量计算,最终实现TWI的精准计算。通过实战步骤指导,帮助读者掌握水文建模和土壤湿度预测的关键技术,适用于农业规划、生态研究等领域。 阅读详情

在前后端分离开发模式中,数据校验是保障接口安全与数据规范的核心环节。行业通用开发原则为:前端校验负责优化用户体验,实时提示输入错误;后端校验负责兜底防护,永远不信任用户提交的任何数据,所有接口入参必须经过后端二次校验。

前端 Element-Plus 组件库默认基于 async-validator 实现表单校验,该库拥有配置灵活、规则丰富、支持 Promise 异步调用、可高度自定义等优势。为了实现前后端校验规则统一、降低维护成本、统一报错格式,我们可以在 Express 后端项目中同样引入 async-validator,实现全栈一致的数据校验体系。

本文基于 Node.js + TypeScript + Express 技术栈,手把手讲解后端集成 async-validator 的完整方案,全程采用 TS 语法编写,代码规范可直接用于项目开发。

如需搭建 Node.js + TypeScript 基础开发环境,可参考:Node.js+TypeScript 开发环境搭建教程

一、核心实现原理

1.1 Express 错误处理机制

Express 框架内置默认错误处理机制,可捕获路由、中间件运行过程中产生的所有错误。开发者可自定义全局错误处理中间件,覆盖框架默认逻辑,实现个性化错误响应、统一格式返回。

Express 硬性规范:自定义全局错误处理中间件必须包含四个固定参数:(err, req, res, next),对应 TS 类型为 ErrorRequestHandler。

1.2 Express 三种错误触发方式

  • 代码运行时自动抛出的语法错误、逻辑错误;

  • 通过 throw new Error() 主动抛出错误;

  • 调用中间件/路由的next(非空参数) 传递错误,交由全局错误中间件捕获。

1.3 后端集成 async-validator 核心思路

  1. async-validator 校验失败时,会返回 reject 状态的 Promise,并携带完整的错误详情;

  2. 通过 try-catch 捕获校验异常,将校验错误信息封装为统一格式;

  3. 通过 next() 将错误抛出,交由全局错误处理中间件统一拦截、格式化响应,实现业务代码与错误处理、校验逻辑解耦。

二、完整集成实现步骤

2.1 安装依赖

安装数据校验核心库 async-validator,原生支持 TypeScript,无需额外安装类型声明文件:

npm i async-validator

2.2 编写全局统一错误处理中间件

在项目中独立封装全局错误中间件,统一处理系统异常和数据校验异常,规范后端接口返回格式,提升前端对接效率。

新建 src/middleWares/errorHandler.ts:

import { ErrorRequestHandler } from "express";

// 全局错误处理中间件(固定四参数)
export const errorHandler: ErrorRequestHandler = (err, req, res, next) => {
  // 处理 async-validator 数据校验错误
  if (err.code === 400) {
    return res.status(400).json({
      code: 400,
      message: "数据校验失败",
      errors: err.msg.errors,
      fields: err.msg.fields
    });
  }

  // 处理系统未知异常
  return res.status(500).json({
    code: 500,
    message: "服务器内部异常,请稍后重试"
  });
};

2.3 封装数据校验中间件

针对具体接口定义校验规则,封装可复用的校验中间件,精准校验请求体参数,业务路由只需专注业务逻辑。

新建 src/middleWares/itemRules.ts:

import Schema, { Rules } from "async-validator";
import { RequestHandler } from "express";

// 定义接口参数校验规则
const descriptor: Rules = {
  name: [
    { required: true, message: "姓名必须填写" },
    { min: 3, max: 30, message: "姓名长度需在3-30个字符之间" }
  ],
  age: [
    { required: true, message: "年龄必须填写" }
  ]
};

// 实例化校验器
const validator = new Schema(descriptor);

// 导出商品新增接口校验中间件
export const itemsPostValidator: RequestHandler = async (req, res, next) => {
  try {
    // 校验请求体数据
    await validator.validate(req.body);
    // 校验通过,放行进入业务逻辑
    next();
  } catch (error) {
    // 校验失败,抛出错误至全局错误中间件
    next({ code: 400, msg: error });
  }
};

2.4 编写业务路由并注册校验中间件

在业务路由中注册对应校验中间件,仅需一行代码即可完成接口校验,无需重复编写判断逻辑。

新建 src/routes/items.ts:

import express from "express";
import { itemsPostValidator } from "../middleWares/itemRules";

export const items = express.Router();

// 商品新增接口:先走校验中间件,再执行业务逻辑
items.post("/", itemsPostValidator, (req, res) => {
  // 校验通过后,正常处理业务(入库、逻辑计算等)
  res.json({
    code: 200,
    message: "数据提交成功",
    data: req.body
  });
});

2.5 全局注册中间件与路由

在项目入口文件统一注册解析中间件、业务路由、全局错误处理中间件,错误中间件必须在所有路由后注册。

新建 src/index\.ts:

import express from "express";
import { errorHandler } from "./middleWares/errorHandler";
import { items } from "./routes/items";

const app = express();
const PORT = 3000;

// 解析 json、form-urlencoded 请求体
app.use(express.json());
app.use(express.urlencoded({ extended: true }));

// 注册业务路由
app.use("/items", items);

// 全局错误处理中间件(必须放在所有路由最后)
app.use(errorHandler);

// 启动服务
app.listen(PORT, () => {
  console.log(`服务启动成功,监听端口:${PORT}`);
});

三、接口测试验证

启动项目后,通过接口测试工具向 http://localhost:3000/items 发送 POST 请求,传入不合法参数,测试校验效果。

测试请求参数

{
  "name": "mu88888888888888888888888888888888888"
}

参数问题:name 长度超出30个字符、必填字段 age 缺失。

接口返回结果

{
  "code": 400,
  "message": "数据校验失败",
  "errors": [
    {
      "message": "姓名长度需在3-30个字符之间",
      "fieldValue": "mu88888888888888888888888888888888888",
      "field": "name"
    },
    {
      "message": "年龄必须填写",
      "field": "age"
    }
  ],
  "fields": {
    "name": [
      {
        "message": "姓名长度需在3-30个字符之间",
        "fieldValue": "mu88888888888888888888888888888888888",
        "field": "name"
      }
    ],
    "age": [
      {
        "message": "年龄必须填写",
        "field": "age"
      }
    ]
  }
}

测试结果:校验规则正常生效,精准拦截非法参数,返回结构化错误信息,前后端可统一对接处理。

四、后端核心注意事项

前端表单提交的所有参数,默认均为 string 类型,因此后端使用 async-validator 需注意类型校验适配:

  1. 常规文本、账号、姓名等字符串参数,可直接使用 type:'string'; 规则,无需额外处理;

  2. 数字、布尔类型参数(年龄、状态、价格等),不建议直接使用 type 强制校验类型,否则会因前端传参均为字符串导致校验失败;

  3. 如需校验数字、布尔类型,可通过transform 主动转换参数类型后再校验,适配前端传参特性,示例如下:

    age: [
    { required: true, message: "年龄必须填写" },
    { transform: (val) => Number(val) },
    { type: "number", message: "年龄必须为数字" },
    { min: 1, max: 120, message: "年龄范围必须在1-120之间" }
    ]
    

五、全文总结

  1. 数据校验必须遵循前端优化体验、后端保障安全的原则,后端不可信任任何用户输入;

  2. Express 通过四参数全局错误中间件,可统一捕获全局异常,实现错误处理逻辑解耦;

  3. 集成 async-validator 可实现前后端校验规则统一,减少重复代码,提升项目可维护性;

  4. 后端校验需适配前端传参特性,通过 transform 解决参数类型不匹配问题,保证校验规则灵活可用。

Python全栈入门到实战【基础篇 05】核心基础:Python的2种运行模式(交互式+命令行式) Python代码运行模式详解:交互式与命令行式对比 摘要: Python提供两种核心运行模式:交互式(REPL)和命令行式(脚本式)。交互式模式适合快速测试语法,即时反馈结果,通过终端输入python启动,特点是无需保存、临时执行,适合验证小段代码逻辑。命令行式模式需将代码保存为.py文件后运行,适合开发完整程序,可重复执行和修改。两种模式各有优势:交互式便于学习调试,命令行式适合实际开发。掌握两种模式的使用场景和切换方法,是Python入门的关键技能,能显著提升学习效率。 阅读详情

相关推荐

T100服务端接口实战:从注册到日志排查的全链路开发指南

本文提供了一份T100服务端接口开发的全链路实战指南。从程序注册与框架签出开始,详细讲解了接口的数据结构设计、核心业务逻辑编写,到最终的部署上线与调用验证。文章重点分享了如何利用日志文件高效定位和排查接口问题,帮助开发者快速掌握T100接口开发的关键步骤与实用技巧。

weixin_28831399的博客 300

Express-----express-validator数据验证

文章预览前言示例1、安装express-validator2、引入3、测试 前言 express-validation是一个中间件,它验证请求的body, params, query, headers 和 cookies ,并且如果任何配置的验证规则失败,返回一个错误的响应 官方文档:https://express-validator.github.io/docs/ 示例 1、安装express-validator npm install express-validator 2、引入 在路由文件中引入

niulinbiao的博客 3475

(UE5 5.2)HISM Mobile DrawInstance在渲染层的实现浅分析

在 (UE4 4.27) UHierarchicalInstancedStaticMesh(HISM)原理分析 这篇博客大致介绍HISM组件从游戏线程到渲染线程的重建KD-Tree和剔除并提交DrawCall逻辑,但是没有分析渲染层的大致数据结构和实现. 可以看出FHierarchicalStaticMeshSceneProxy 实际存储Instance数组数据来自于FInstancedStaticMeshSceneProxy FHierarchicalStaticMeshSceneProxy只是以FClu

qq_29523119的博客 2728

express文件上传,参数验证

一、multer Multer 会添加一个 body 对象 以及 file 或 files 对象 到 express 的 request 对象中。 body 对象包含表单的文本域信息,file 或 files 对象包含对象表单上传的文件信息。 安装 npm i multer 文档地址 https://github.com/expressjs/multer/blob/master/doc/README-zh-cn.md 二、在express中使用 2.1全局使用 const multer = requir

weixin_42952411的博客 765

Materials Studio新手必看:COD数据库快速查询与晶体文件导入实战

本文为Materials Studio新手提供了从COD数据库快速查询晶体结构到成功导入软件的完整实战指南。详细解析了CIF文件格式、高效检索技巧、关键导入步骤及常见问题排错,帮助计算化学初学者高效获取可靠结构数据,为后续模拟计算奠定坚实基础。

weixin_29290259的博客 1065

使用Simulink对液流电池在微电网中的动态响应进行建模与仿真

本文介绍了使用Simulink对液流电池在微电网中的动态响应进行建模与仿真的方法。通过搭建包含液流电池、双向DC-DC变换器、分布式能源和负载的微电网模型,并设计基于SOC的控制器,详细说明了从模型创建到仿真运行的完整流程。重点分析了液流电池在不同负载条件下的动态特性,评估了系统响应速度、充放电效率和稳定性等性能指标。该仿真方法为验证液流电池在微电网中的应用提供有效工具,有助于优化参数设计和提升系统可靠性。

amy_mhd的博客 137

【Express.js】express-validator

【Express.js】express-validator

Evanpatchouli 的博客 1651

11.11华为OD机试真题 新系统 - 管线同类区段归并 (Java/Py/C/C++/Js/Go)

11.11华为OD机试真题 新系统 - 管线同类区段归并 (Java/Py/C/C++/Js/Go)

算法大师! 165

node中使用express-validator对客户端提交的数据进行表单验证

对bodycheck():检查字段是否存在。const {isEmail():检查字段是否为合法的Email地址。const {if(!isLength():检查字段的长度是否符合要求。const {isJSON():检查给定字段是否是有效的 JSON 字符串。const {// 处理请求 });isEmpty():检查给定字段是否为空。const {// 处理请求 });matches():检查字段是否匹配正则表达式。const {custom():自定义校验函数。

jieyucx的博客 2173

uni-app - 最详细 H5 网页接入微信登录功能,提供公众号配置与详细注释示例代码(移动端网页实现点击登录按钮后 调用微信公众号授权登录功能 详细讲解接入流程与详细示例代码)官方最新超级详细教程

uniapp中H5微信登录,uniapp H5微信授权登录,微信公众号第三方网页(H5)授权登录(OAuth2.0)流程及逻辑详细教程,UNIAPP 开发H5 怎么实现微信公众号登录功能,uniapp如何实现H5网页的公众号微信登录,怎么做uniapp微信登录,uniapp h5项目怎么实现微信登录的功能,uniapp微信浏览器H5授权微信登录,UniApp开发H5接入微信登录的全过程,uniapp的H5页面使用微信登录,uniapp H5微信授权登录,H5之微信授权登陆 (uniapp网页版微信授权登录)

🏆 前端领域优质创作者 7410

微信小程序|基于小程序实现定位打卡功能

此文主要在小程序内实现打卡功能,可根据用户位置与公司设定的打卡范围实时判断打卡是否合法,并在后台对打卡记录进行管理。

商务合作 / 项目定制 / 学习交流。个人vx:lovely_wml 1万+

async-validator详细用法

sync-validator是一个表单的异步验证的第三方库。传入验证规则对象,可以新建一个验证器对象。验证器对象的`validate`方法用于验证数据是否符合验证规则。

dreamingbaobei的博客 3万+

汉书HE8,好用的汇编代码编写工具

汉书HE8,好用的汇编代码编写工具早期编写汇编代码所用功能强大

Express-Validator实战:构建高可靠表单验证与数据清洗体系

表单验证是Web API安全与数据质量的第一道防线,其本质是请求数据的语义校验与结构化清洗。基于Express中间件生命周期设计的验证方案,需兼顾字段级精度、实时流式处理能力及生产环境 sanitization 能力。Express-Validator 以 Joi 规则引擎为内核,通过 validation + sanitization 双阶段流水线,在不改变 req.body 原始形态前提下,实现自动 trim、normalizeEmail、escape 等清洗操作,并支持异步唯一性校验与嵌套对象深度验证

weixin_30329623的博客 419

TMS_WebGMaps_1.9.8.0_Full_Source

TMS_WebGMaps_1.9.8.0_Full_Source 全源码 delphi cbuilder

jre9下载 jdk9

(Java SE Runtime Environment 9.0) 9.0u175 官方最新版 【x86|x64】

使用routing-controllers简化Express项目开发

在Node.js后端开发中,Express框架因其轻量灵活被广泛使用,但传统路由管理方式存在代码分散、重复劳动等问题。装饰器(Decorator)作为TypeScript的重要特性,通过元编程方式为代码组织结构化提供了新思路。routing-controllers库巧妙结合装饰器模式与Express框架,实现了类似Spring MVC的声明式路由管理。该方案通过@Controller、@Get等装饰器将路由逻辑集中到类方法中,配合class-validator实现参数自动验证,大幅提升了代码可维护性和开发效

weixin_33906657的博客 403

文档:亲测可用解决vnc灰屏,黑屏,鼠标大黑叉情况

主要解决vnc-viewer灰屏,黑屏,鼠标大黑叉等现象,详细见文档。

Hermes Voice Echo Show屏幕详解:让旧屏实时展示AI思考、回复与后台任务

Hermes Voice 是一款通过 Home Assistant Assist 语音操控 Hermes Agent 的开源项目。本文详解它最有意思的部分:Hermes Screen——把一台旧 Echo Show 变成 AI 助手的"可视化大脑",实时展示它听到的问题、正在调用的工具、流式写出的回复,以及后台任务看板上正在运行的工作,让 AI 的思考过程从"黑盒"变成看得见的内容。 ## 一、

gitblog_01199的博客 409

百来元自制一台可编程四轴无人机:ESP-Drone 从固件编译到首次起飞

如果你想要一台飞控固件开源、可以自由改代码的四轴无人机,往往会卡在两个地方:商品机的固件是封闭的,教学用的开源方案又常常硬件复杂或成本偏高。ESP-Drone 是乐鑫(Espressif)开源的 ESP32 无人机方案,基于 ESP32 / ESP32-S2 / ESP32-S3 芯片,支持自稳定、定高、定点三种飞行模式,可以用手机 APP 或游戏手柄通过 Wi-Fi 直接控制,核心飞控代码移植自

gitblog_00061的博客 340

Express集成routing-controllers:提升路由管理的效率与可维护性

在现代Web开发中,路由管理是后端架构的核心组成部分。传统的Express路由处理常面临代码冗余和维护困难的问题。通过装饰器(Decorator)技术,routing-controllers库实现了基于类的路由定义,将路由逻辑集中管理,显著提升代码可读性和可维护性。其核心原理是利用TypeScript的装饰器特性,自动处理参数绑定、请求验证和响应格式化。这种技术特别适合中大型项目,能有效减少代码量(实践案例显示可减少75%的路由层代码),同时保持与原生Express相近的性能表现(性能差异小于2%)。典型应

weixin_33947521的博客 393

Ant 游戏引擎上手指南:三步编译、12 行代码跑通 3D 渲染管线

Ant 游戏引擎是灵犀互娱开源的 Lua + C++ 游戏引擎:用声明式 feature 组装 65 个功能包,用 .ecs 文件在编译期生成 ECS 组件,渲染侧基于 bgfx 提供 180 个着色器源与 TAA、FSR、Bloom 等后期效果,支持 Windows、macOS、Android、iOS。本文面向第一次接触它的开发者,讲清项目全貌、编译步骤、最小示例与高频坑。 ## 项目速览:先

gitblog_01100的博客 228

Express-Validator 从 v5 迁移到 v6 完全指南

Express-Validator 是 Express 框架中用于数据验证和清理的重要中间件。随着版本 6 的发布,该库进行了重大重构,带来了更现代化的 API 设计和更好的异步支持。本文将详细介绍如何将项目从 v5 迁移到 v6 版本。 ## 环境要求变更 首先需要注意的是,v6 版本不再支持 Node.js 6。如果你的项目还在使用 Node.js 6,需要先升级到 Node.js 8 或...

gitblog_00517的博客 514

Express.js + TypeScript 5.5 实战:3 种常见类型错误与修复方案

本文深入探讨了Express.js与TypeScript 5.5结合开发时常见的三类类型错误,包括Request/Response类型扩展、中间件类型声明和第三方库类型缺失问题,并提供了实用的修复方案。通过详细的代码示例和类型安全实践,帮助开发者提升后端开发效率,确保类型系统的优势得到充分发挥。

weixin_30621959的博客 339

Win11Debloat 上手指南:免费快速移除 Windows 11 预装应用、关闭遥测与广告

新装的 Windows 11 里,任务管理器常驻着一批你没装过也不想装的应用,锁屏天天弹小贴士,Edge 里嵌着广告推荐。Win11Debloat 是一个免费的开源 PowerShell 脚本,一次运行就能移除预装应用、关闭遥测和广告推送,把 Windows 10/11 精简成你想要的样子——不用装软件,不用逐条翻注册表。 ## 📋 Win11Debloat 项目档案 | 项目 | 事实 |

gitblog_00524的博客 653

基于OpenAPI契约的前后端高效协作:告别联调内耗,实现并行开发

在现代Web开发中,前后端分离架构已成为主流,但随之而来的协作摩擦也日益凸显。其核心在于缺乏一份清晰、无歧义的接口契约,导致开发节奏不同步、联调阶段问题集中爆发。API接口规范,特别是OpenAPI/Swagger这样的机器可读描述语言,为解决这一问题提供了标准化的方案。它通过精确描述接口路径、请求响应格式、数据类型及约束,将模糊的口头约定转化为可执行的协议。其技术价值在于,它能自动生成类型定义和Mock服务,使前端能在后端接口未完成时独立开发与测试,实现真正的并行开发,从而大幅提升工程效率。在应用场景上,

weixin_33913332的博客 651

benchmark_pipeline.py命令行实战指南:3步掌握MotionGraphicsBench生成、渲染、验证全阶段(含Ollama与vLLM本地模型配置)

本文是 **MotionGraphicsBench**(Figma 团队发布的动效生成评测基准)中 [benchmark_pipeline.py](https://link.gitcode.com/i/8b7fd9727e73abfbc9cded121f7f643a) 的完整命令行教程:一条命令打通「大模型生成 GSAP 动画 → 渲染为 SVG 帧 → 程序化验证」三个阶段,并覆盖 Ollama

gitblog_00665的博客 319

Aurelio AI模型选择与成本清单:OpenRouter接入实测,一个问题只要几分钱

[Aurelio](https://link.gitcode.com/i/e805dcbbf8abec5d800cadafff291834) 是一款运行在自家电脑上的开源个人理财应用,内置可对话的 AI 理财顾问。接入 **OpenRouter** 后,它的全部 AI 能力都按实际提问计费:实测中一个追问大约 **0.021 美元**,首次提问 **0.11 到 0.12 美元**,一次完整组合分

gitblog_00097的博客 354

Express中间件机制深度解析与实现原理

中间件是Web开发中的核心概念,本质上是处理HTTP请求/响应的可插拔组件。其工作原理基于洋葱圈模型,通过顺序执行、共享上下文等特性实现请求处理流程控制。在Node.js生态中,Express框架的中间件系统因其简洁高效而广受欢迎,支持应用级、路由级等多种类型。理解中间件机制不仅能优化Web应用性能,还能实现认证、日志等通用功能的高效复用。本文以Express为例,深入剖析中间件注册、路由匹配、next机制等实现细节,并对比Koa的异步中间件设计,帮助开发者掌握中间件开发与调试技巧。

weixin_33834910的博客 359

Express框架构建RESTful API实战指南

RESTful API作为现代Web开发的核心技术,通过HTTP协议实现前后端分离架构的数据交互。其设计原则包括无状态通信、统一接口和资源导向,采用JSON作为主流数据格式。Express作为Node.js生态中最流行的轻量级Web框架,凭借中间件机制和路由系统,能够高效构建高性能API服务。在接口安全方面,JWT认证和速率限制成为保护系统的关键技术,而Swagger文档工具则解决了API可维护性问题。本实战案例展示了如何基于Express+MVC架构,快速实现包含用户认证、数据查询等功能的后台管理系统接口

weixin_30430169的博客 456
上一篇: Express框架路由处理函数和中间件函数使用注意事项梳理
下一篇: HTTPS一文通
cppandtea
博客等级 码龄7年 42粉丝 12原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值