本文详解如何使用 JSON Schema 的 pattern 关键字，配合正则表达式 S+，严格拒绝空字符串及仅含空白字符（如 " "）的非法输入，弥补 minLength: 1 在语义层面的校验缺口。
本文详解如何使用 json schema 的 `pattern` 关键字，配合正则表达式 `s+`，严格拒绝空字符串及仅含空白字符（如 `" "`）的非法输入，弥补 `minlength: 1` 在语义层面的校验缺口。
在 JSON Schema 中，"minLength": 1 仅确保字符串长度 ≥ 1，但无法识别语义上的“空值”——例如由空格、制表符或换行符组成的字符串 " " 或 " "。这类值虽 technically 非空，却常被业务逻辑视为无效名称，若放行将导致下游数据污染、UI 显示异常或搜索失效等问题。
要真正实现“非空且含有效字符”的校验，必须结合正则表达式进行语义级约束。推荐方案是使用 pattern 关键字，匹配至少一个非空白字符（即 S+）：
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"pattern": "^\S+$"
}
},
"required": ["name"]
}
✅ 此 Schema 将通过以下校验：
- "name": "Alice" → ✅（含非空白字符）
- "name": "Zhang 3" → ✅（含空格但存在非空白字符）
❌ 并明确拒绝以下非法值：
- "name": "" → ❌（minLength: 1 先拦截）
- "name": " " → ❌（^\S+$ 要求从头到尾均为非空白字符，空格不匹配）
- "name": " " → ❌（制表符、换行符、回车符均属空白字符 s，S 为其反集）
? 正则说明：
- ^ 表示字符串起始，$ 表示结束，确保整个字符串满足条件；
- S 是 s 的否定，匹配任意非空白字符（等价于 [^s]）；
- + 表示“一个或多个”，即至少出现一次非空白字符。
组合 ^S+$ 即表示：“字符串必须由一个或多个非空白字符组成，且不能包含任何空白字符”。
⚠️ 注意事项：
- JSON 字符串中反斜杠需转义，故 S 写作 "\S"；
- 若需允许中间有空格（如 "John Doe"），但禁止首尾空白，应改用 "^[^\s]+(\s+[^\s]+)*$" 或更稳妥的 "^[^\s].*[^\s]$"（并配合 minLength: 2），但需权衡可读性与覆盖场景；
- 所有主流 JSON Schema 校验器（如 AJV、jsonschema、Jackson JsonSchema Module）均支持 pattern，无需额外依赖；
- pattern 仅对 type: "string" 生效，与其他类型组合时需显式声明 type。
总结而言，minLength 解决的是“长度问题”，而 pattern 解决的是“内容语义问题”。在生产环境的 Schema 设计中，二者应协同使用：以 minLength 做基础防护，以 pattern 做业务兜底。这不仅是技术细节的补全，更是数据契约严谨性的体现——真正的“非空”，从来不只是字节长度的判断，而是业务意义的有效性确认。
