本文详解如何在 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 Localizing Video

用于端到端视频本地化流程的轻量编排器，路由至四个专注子技能——/wjs-transcribing-audio、/wjs-translating-subtitles...

下载

• ^\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 定语义”的双重校验策略，才能真正守住接口数据质量的第一道防线。