如何使用XML Schema中的xs:restriction结合正则模式进行XSD约束？

本文共计841个文字，预计阅读时间需要4分钟。

在XML Schema（XSD）中，``元素使用的确实是XPath 2.0的正则子集。它不支持`\d`、`\w`等转义字符，也不支持量词（如`+`、`*`、`?`等）。此外，``元素内不应直接使用量词，除非是在``元素内部显式启用`flags`属性。

• 必须用 [0-9] 替代 \d，[a-zA-Z] 替代 \w
• 量词只认 *（0次或多次）、+（1次或多次）、?（0或1次）、{n}、{n,}、{n,m} —— 但某些老解析器（如 .NET 4.0 前的 XmlSchemaSet）会忽略 {n,m}
• 锚定行为特殊：pattern 默认是“全字符串匹配”，不需要显式加 ^ 和 $；加了反而可能出错

多个 xs:pattern 会做逻辑 AND，不是 OR

一个 xs:restriction 下写多个 xs:pattern，表示“必须同时满足所有正则”，不是“满足任一即可”。比如限制邮箱既要含 @，又要以 .com 结尾，两个 pattern 都得通过。

• 想表达“OR”逻辑，得合并进单个正则，比如 [a-z]+@example\.(com|org)
• 注意转义：点号 . 在 pattern 中是字面量，要匹配真实点号就得写 \.，但反斜杠本身在 XML 中需写成 \ 或直接 \.（取决于解析器对实体的处理）
• 部分工具（如 older Xerces）对连续多个 xs:pattern 的顺序敏感，建议把更严格的 pattern 放前面，减少无效校验开销

pattern 不校验空字符串，得靠 minOccurs 或 xs:minLength 补位

xs:pattern 只在值非空时触发。如果元素允许为空（minOccurs="0"）或类型是可选字符串，"" 会绕过所有 pattern 检查。

• 需要禁止空值，得额外加 xs:minLength value="1"
• 若字段语义上不能为空，优先用 minOccurs="1" + xs:minLength，而不是只靠 pattern
• 注意：XSD 1.0 不支持 xs:assert，所以无法写“非空且匹配 pattern”的复合条件，只能分层约束

Java / .NET 解析器对 pattern 的实际支持差异很大

同一个 pattern，在 JDK 8 的 javax.xml.validation、.NET Framework 4.8 的 XmlSchemaSet、以及 libxml2（用于 Python lxml）里，行为可能不一致 —— 尤其涉及 Unicode、空白字符、或边界匹配。

• JDK 默认用 Xerces，支持 flags="i"（忽略大小写），但不支持 flags="u"（Unicode 模式）
• .NET 对 \s 解释为 ASCII 空白，不匹配 Unicode Zs 类别的空格（如  ）
• 测试时务必用目标运行时的真实 validator，别只靠在线 XSD 校验网站

真正麻烦的是 pattern 和 xs:whiteSpace 的交互：如果设了 preserve，换行符和制表符会参与匹配；设 collapse 则先归一化再校验 —— 这个细节几乎没人查文档，直到线上数据莫名被拒。