OpenAPI规范是否要求校验器匹配路径前执行URL规范化？校验器存缺陷

OpenAPI规范（包括3.x版本）并没有强制要求校验器在路径匹配前必须执行URL canonicalization（URL规范化）操作。不过，规范对路径匹配的默认行为有明确定义：默认情况下，带末尾斜杠和不带末尾斜杠的路径会被视为两个独立的路径——比如/abc/path和/abc/path/在默认规则里是两个不同的路径条目。

你遇到的校验器只对不带末尾斜杠的路径生效，本质是它严格遵循了规范的默认路径匹配规则，没有自动处理末尾斜杠的情况。要解决这个问题，通常有两种可行思路：

• 检查你使用的校验器是否提供配置项，允许忽略路径末尾的斜杠，或者自动执行URL规范化（比如自动移除末尾斜杠、解码转义字符等）。很多主流OpenAPI校验工具都支持这类配置。
• 如果校验器没有相关配置，可以在请求到达校验器之前，通过网关、中间件或业务代码先对URL做规范化处理，统一移除末尾斜杠（或按需求做其他规范化操作），再传递给校验器处理。

另外，也可以在API定义层面兼容两种路径：同时在OpenAPI文档中定义带末尾斜杠和不带末尾斜杠的路径，或者用路径参数通配符覆盖，但这种方式会增加文档冗余，不如前两种方法高效。

内容的提问来源于stack exchange，提问作者Luis Abreu