如何将class-validator实现为中间件 及更新操作验证与验证模式最佳实践
基于现有class-validator中间件的更新验证实现与合理校验模式
一、基于现有方案实现更新操作验证的落地方法
你当前写的注册校验中间件,核心问题是硬编码逐字段赋值、和数据库User实体强耦合,没法直接复用到更新场景,只要稍作改造就能无缝适配需求:
- 替换硬编码赋值逻辑,减少重复代码
原来手动user.username = req.body.username逐字段赋值的逻辑,可以直接用class-transformer的plainToInstance实现:自动把req.body的普通对象转成对应校验类的实例,不用每写一个接口就重复手写一遍赋值代码。 - 利用class-validator原生能力适配更新场景的校验规则
更新操作和注册操作的核心校验差异是:注册要求所有必填字段必须存在且校验通过;更新只需要校验前端实际传了的字段,没传的字段不能触发必填校验报错。
这个需求刚好对应class-validator自带的skipMissingProperties配置:开启后,所有请求里没传的属性会直接跳过校验逻辑,仅对传入的字段做格式合法性校验。 - 把单功能的注册中间件改成可复用的中间件工厂
你现在的中间件只能给注册接口用,改造成接收DTO类、自定义校验配置参数的工厂方法后,就能同时覆盖注册、更新两类场景,而且完全不影响你现有代码的分层逻辑——中间件校验通过后,Controller再做密码哈希、调用Service层的逻辑一点都不用改动。
改造后的核心代码参考:
具体使用方式:import { plainToInstance } from 'class-transformer'; import { validate } from 'class-validator'; import { Request, Response, NextFunction } from 'express'; // 通用校验中间件工厂,替换原有硬编码的注册中间件 export const buildValidatorMiddleware = (DtoClass: any, customOptions: object = {}) => { return async (req: Request, res: Response, next: NextFunction) => { // 自动把请求体转成对应DTO的类实例,无需手动逐字段赋值 const dtoInstance = plainToInstance(DtoClass, req.body); const fieldErrors = await validate(dtoInstance, { // 注册场景默认配置:不跳过缺失属性,全量校验必填项 skipMissingProperties: false, // 自定义配置覆盖默认值,更新场景传入 { skipMissingProperties: true } 即可 ...customOptions }); if (fieldErrors.length > 0) { const errors = ValidatorErrToFieldErr(fieldErrors); next(new HttpExeception({ statusCode: httpCode.BAD_REQUEST, errors })); return; } // 校验通过后把DTO实例挂在req对象上,后续Controller/Service直接取用 req.validatedBody = dtoInstance; next(); }; };- 注册接口:调用工厂传入注册用的DTO类,用默认的全量校验逻辑,和你现有手写的注册校验效果完全一致
- 更新接口:用同一个工厂方法传入更新用的DTO类,额外加配置
{ skipMissingProperties: true },就能实现“仅校验传入字段格式、不强制要求所有字段存在”的更新校验需求。
二、结合你当前分层架构的合理校验模式
按照你现在Controller处理业务逻辑、Service层操作数据库的分层设计,合理的校验模式需要严格划清边界,避免耦合和安全风险:
- 校验载体和数据库实体解耦,不要直接用TypeORM的User实体当校验类
你现在直接new User()(数据库实体)做校验的方式有明确的安全隐患:User实体上可能挂着isAdmin、id这类和普通注册/更新流程无关的字段,之前你是手动逐字段赋值还好,哪天改成直接把req.body整个塞进实体里,万一前端传个isAdmin: true,就可能直接被持久化到数据库,造成越权。
正确的做法是把校验逻辑的载体拆成独立的DTO类:UserCreateDTO:只定义注册流程需要的username、email、password三个字段,对应挂上@IsEmail、@MinLength这类校验装饰器,从结构上就不包含isAdmin这类敏感字段,就算前端传了也会被自动过滤UserUpdateDTO:直接继承UserCreateDTO,复用所有字段的校验规则,不用重复写一遍装饰器
- 严格划分两层校验的职责边界
- 中间件层:只做纯格式层面的校验——比如字段格式是否合规、字符串长度是否达标、必填字段是否存在,这层不碰任何数据库逻辑,保证代码可复用。
- Service层:做业务规则层面的校验——比如邮箱是否已被其他用户注册、当前用户是否有权限修改对应字段、要操作的资源是否存在。你现在在Controller层捕获数据库唯一约束错误(23505)转成字段错误的逻辑,也可以下沉到Service层,做成明确的业务校验,减少Controller的冗余代码。
- 复用统一的错误转换逻辑
你现在写的ValidatorErrToFieldErr把class-validator的原始错误转成前端可识别格式的逻辑,要作为通用能力复用,所有校验场景都走同一套转换逻辑,避免不同接口的错误返回格式不一致。
内容的提问来源于stack exchange,提问作者Dewinpena
相关产品推荐
相关产品推荐

