本文详解如何在 JSON Schema 中精准拦截仅含空格的字符串（如 " "），仅靠 minLength: 1 不足，需结合正则表达式 pattern 实现语义级非空校验，并支持自定义错误提示。
本文详解如何在 json schema 中精准拦截仅含空格的字符串（如 `" "`），仅靠 `minlength: 1` 不足，需结合正则表达式 `pattern` 实现语义级非空校验，并支持自定义错误提示。
在 JSON Schema 数据校验实践中，一个常见误区是认为设置 "minLength": 1 即可确保字符串“非空”。但实际上，该约束仅校验字符数量，无法识别语义上的空值——例如 " "（三个空格）、" " 或 "u00A0"（不间断空格）均满足 minLength: 1，却在业务逻辑中应被视为非法输入。
要真正实现“非空白字符串”（non-whitespace string）校验，必须借助 pattern 关键字，使用正则表达式匹配至少一个非空白字符（即 S）。推荐模式如下：
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"pattern": "^\S+$",
"errorMessage": {
"pattern": "名称不能为空，且不能仅包含空格、制表符或换行符"
}
}
},
"required": ["name"]
}✅ 关键说明：
Wjs Uploading Video
下载
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
- ^\S+$ 是核心正则：^ 表示开头，$ 表示结尾，\S+ 匹配一个或多个非空白字符（S 等价于 [^ ]），从而彻底排除纯空白字符串；
- minLength: 1 作为兜底，增强可读性并兼容不支持 pattern 的简易校验器；
- errorMessage（非标准但被主流验证器如 Ajv 支持）用于提供面向用户的友好提示，避免暴露正则细节。
⚠️ 注意事项：
- JSON Schema 中反斜杠需双写（\S），否则会被 JSON 解析器误读；
- 若需兼容 Unicode 空白（如中文全角空格、零宽空格），建议使用更健壮的模式："pattern": "^[^\s\uFEFF\u200B]+$"，其中 uFEFF（BOM）和 u200B（零宽空格）常被忽略；
- 避免使用 "(?!^\s*$).+" 这类负向先行断言——部分旧版验证器（如早期 json-schema-validator）对其支持不完整，^\S+$ 兼容性更优。
? 进阶建议：
对于需要统一治理的微服务或低代码平台，可将此类校验封装为可复用 Schema 片段，例如：
{ "$ref": "#/definitions/nonWhitespaceString" }
// 在 definitions 中定义：
"nonWhitespaceString": {
"type": "string",
"minLength": 1,
"pattern": "^\S+$",
"errorMessage": "字段值不可为空白"
}此举提升 Schema 可维护性，也便于团队共建数据契约规范。
综上，pattern 是 JSON Schema 中实现语义化字符串校验不可替代的关键能力。坚持“minLength 定长度、pattern 定语义”的双重校验策略，才能真正守住接口数据质量的第一道防线。
