如何配置req.query校验规则仅接受YYYY-MM-DD格式日期、拦截随机数字输入
req.query 日期参数严格校验实现方案
为什么你的校验会放行"123456"这类无效值
绝大多数人写校验时的逻辑漏洞在于:仅用new Date(输入值)判断是否能解析为日期对象,但JS原生Date构造函数对字符串的解析是高度宽松的——比如传入"123456"会被解析为距1970-01-01 00:00:00的偏移时间戳,生成完全合法的Date实例,自然不会触发校验失败。
要实现严格的YYYY-MM-DD格式校验,必须叠加两层约束:
- 先卡字符串本身的格式特征,不满足横杠分隔、长度匹配的直接拦截
- 再校验该字符串对应的是真实存在的日期,而不是格式对但数值非法的伪日期
方案1:Express + express-validator 中间件校验
这是Express项目最常用的校验方案,直接在路由层配置校验链即可拦截无效参数,不需要写大量业务代码:
const { query, validationResult } = require('express-validator') router.get('/your-interface', // 配置日期参数的校验规则 query('targetDate') .trim() // 去掉参数首尾的多余空格 .notEmpty().withMessage('targetDate为必填查询参数') // 先卡基础字符串格式,类似"123456"这类无横杠的输入会被这步直接拦截 .matches(/^\d{4}-\d{2}-\d{2}$/).withMessage('日期必须符合YYYY-MM-DD格式') // 严格模式校验真实日期,拦截"2023-13-01""2024-02-30"这类格式对但不存在的日期 .isDate({ format: 'YYYY-MM-DD', strictMode: true }).withMessage('输入值不是合法的日期'), (req, res) => { // 收集校验错误,存在错误直接返回400,不进入业务逻辑 const errors = validationResult(req) if (!errors.isEmpty()) { return res.status(400).json({ errors: errors.array() }) } // 校验通过后的正常业务处理 } )
方案2:Zod Schema 校验
如果项目用Zod做参数校验,直接在Schema定义中叠加格式约束即可:
const z = require('zod') // 定义查询参数的校验规则 const QueryParamsSchema = z.object({ targetDate: z.string({ required_error: '缺少targetDate参数' }) .regex(/^\d{4}-\d{2}-\d{2}$/, '日期格式必须为YYYY-MM-DD') // 验证是否为真实合法日期 .refine((dateStr) => !isNaN(Date.parse(dateStr)), '输入值不是合法日期') }) // 接口内调用校验 app.get('/your-interface', (req, res) => { const validateResult = QueryParamsSchema.safeParse(req.query) if (!validateResult.success) { return res.status(400).json({ error: validateResult.error.issues }) } // 校验通过的参数可直接从validateResult.data中获取 })
方案3:无第三方依赖的原生手写校验
如果不想引入额外的校验库,可以直接写通用校验函数实现:
/** * 校验输入值是否为合法的YYYY-MM-DD格式日期 * @param {string} dateStr 待校验的字符串 * @returns {boolean} 校验通过返回true,否则返回false */ function isValidISODate(dateStr) { // 第一步:拦截所有不符合基础格式的输入,比如"123456""2024/01/01" if (!/^\d{4}-\d{2}-\d{2}$/.test(dateStr)) return false // 解析各部分数值 const [year, month, day] = dateStr.split('-').map(Number) // 生成Date实例时月份需要减1(JS月份从0开始计数) const date = new Date(year, month - 1, day) // 比对生成的日期和输入的数值,拦截"2024-02-30""2023-13-05"这类无效日期 return date.getFullYear() === year && date.getMonth() === month - 1 && date.getDate() === day } // 接口内使用 app.get('/your-interface', (req, res) => { const inputDate = req.query.targetDate if (!isValidISODate(inputDate)) { return res.status(400).send('日期参数不合法,仅支持YYYY-MM-DD格式的有效日期') } // 正常业务逻辑 })
常见踩坑提醒
- 不要仅依赖Date构造函数做合法性判断:宽松解析特性会让大量不符合格式要求的输入被判定为合法
- 不要仅靠正则校验不做真实日期校验:正则只能匹配字符串结构,无法识别不存在的日期(比如2月30号、13月)
- 用第三方校验库时务必开启严格模式:默认的宽松解析会把斜杠分隔、英文拼写的日期也判定为合法,不符合你的格式要求
内容的提问来源于stack exchange,提问作者rainier-albario
相关产品推荐
相关产品推荐

