ajv 在进行 uri 格式校验时，严格遵循 rfc3986 规范，这可能导致其对某些看似不规范的 uri 字符串（如包含 `.` 和 `=` 的路径）判断为有效，与部分在线工具的校验结果不同。本文将深入探讨 ajv 的 uri 校验机制，并通过示例代码解析其行为，帮助开发者理解并正确使用 ajv 进行 uri 格式验证。

Ajv URI 格式校验的核心原则

许多开发者在使用 Ajv 结合 ajv-formats 进行 JSON Schema 校验时，可能会对 URI 格式的校验结果产生疑问。特别是当一个 URI 字符串在某些在线校验工具中被标记为无效，但在 Ajv 中却被判断为有效时，这种困惑尤为常见。其核心原因在于 Ajv 对 format: "uri" 的实现严格遵循了 RFC3986 这一 URI 规范。

RFC3986 定义了 URI 的通用语法，它允许 URI 的路径部分包含比我们日常认知中更广泛的字符。例如，字符 . (点) 和 = (等号) 在 RFC3986 中被归类为“子定界符”（sub-delims），是允许出现在 URI 路径段中的字符。因此，一个包含这些字符的 URI 字符串，只要符合 RFC3986 的结构要求，就会被 Ajv 视为有效。

示例解析

让我们通过一个具体的例子来理解 Ajv 的这一行为。考虑以下 JSON Schema 和待校验的数据：

import Ajv from 'ajv';
import addFormats from 'ajv-formats'; // 注意：在CommonJS环境中使用 require，在ESM环境中使用 import

const myData = { a: "https://a.=.c" };

const mySchema = {
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "a": {
      "type": "string",
      "format": "uri"
    }
  }
};

const ajv = new Ajv({ strict: true, allErrors: true, verbose: true });
// 注册 ajv-formats 插件以启用格式校验
addFormats(ajv);

const isValid = ajv.validate(mySchema, myData);

console.log(`校验结果: ${isValid}`);
if (!isValid) {
  console.log('校验错误:', ajv.errors);
}

运行上述代码，你会发现 isValid 的值为 true。这与一些在线 JSON Schema 校验器（例如 jsonschem*alidator.net）可能报告的错误形成了对比。在线工具可能采用了更严格或基于特定场景的 URI 验证规则，而 Ajv 坚持的是 RFC3986 的通用定义。

具体到 https://a.=.c 这个 URI 字符串：

• https 是合法的 scheme。
• a 是合法的主机名。
• . 和 = 在 RFC3986 中是允许出现在路径段中的“子定界符”。
• c 也是合法的路径字符。

因此，从 RFC3986 的角度来看，https://a.=.c 是一个格式正确的 URI。

AI Surge Cloud

低代码数据分析平台，帮助企业快速交付深度数据

87 查看详情

注意事项与替代方案

1. ajv-formats 的重要性： Ajv 本身不包含所有格式的校验逻辑。为了启用 format 关键字的校验，必须安装并注册 ajv-formats 插件。如果忘记注册，format 关键字将被忽略，导致所有字符串都被视为有效。

2. 理解标准： 在使用 format 关键字时，务必查阅 JSON Schema 官方文档以及相关 RFC 规范，以理解其背后遵循的具体标准。这有助于避免对校验结果产生误解。

3. 更严格的 URI 校验： 如果你的应用场景需要比 RFC3986 更严格的 URI 校验规则（例如，不允许路径中出现某些特殊字符，或者要求特定的域名结构），你可以考虑以下两种方案：

   • 自定义格式（Custom Formats）： Ajv 允许你定义自己的自定义格式。你可以编写一个函数，使用正则表达式或其他库（如 validator.js）来实现更严格的 URI 校验逻辑，然后将其注册为 Ajv 的自定义格式。

     ajv.addFormat('strict-uri', {
       type: 'string',
       validate: (uri) => {
         // 使用更严格的正则表达式或第三方库进行校验
         // 例如，一个更严格的正则，可能不完全符合所有RFC，但满足特定需求
         const strictUriRegex = /^(https?|ftp):\/\/[^\s/$.?#].[^\s]*$/i;
         return strictUriRegex.test(uri);
       }
     });
     // 在 schema 中使用 "format": "strict-uri"

   • pattern 关键字： 对于简单的、基于正则表达式的额外限制，可以直接在 JSON Schema 中使用 pattern 关键字。

     {
       "type": "string",
       "format": "uri",
       "pattern": "^https?://[a-zA-Z0-9.-]+$" // 示例：一个更严格的模式，要求只有字母、数字、点、横线
     }

     请注意，pattern 关键字会与 format 关键字协同工作，提供双重校验。

总结

Ajv 对 format: "uri" 的处理是基于其对 RFC3986 规范的严格遵循。理解这一基础是正确使用 Ajv 进行 URI 校验的关键。当遇到与预期不符的校验结果时，首先应回顾相关的 RFC 规范，而非简单地认为 Ajv 存在“缺陷”。如果默认的 RFC3986 校验不足以满足业务需求，开发者应主动利用 Ajv 提供的自定义格式或 pattern 关键字，以实现更精细、更严格的验证逻辑。

以上就是深入理解 Ajv 的 URI 格式校验：基于 RFC3986 的行为解析的详细内容，更多请关注其它相关文章！

# json  # 正则表达式  # 工具  # .net  # 自定义  # 这一  # js  # 南通seo外包方案  # seo排名还上不去  # 最专业的网站建设团队  # 推广网站简历怎么做的  # 泰安营销网站建设  # 宜昌企业网站建设  # 通州网站建设外包  # 物流网站建设课程定位  # 奎文网站优化  # 律师的推广营销策略分析  # 自己的  # 如何实现  # 服务端  # 其对  # 如何使用  # 出现在  # 你可以 

相关栏目： 【 科技资讯46185 】 【 网络学院92790 】

相关推荐： windows10怎么关闭系统提示音_windows10彻底静音设置方法  php源码怎么在电脑上测试_电脑测试php源码方法步骤【教程】  高德地图总提示网络异常怎么办 高德地图离线导航设置与网络排查方法  html两个JS只运行一个怎么办_让双JS在html中都运行方法【技巧】  Angular Material 垂直步进器：实现底部到顶部排序的教程  深入理解J*a编译器的兼容性选项：从-source到--release  Go与Ruby之间实现AES加密互通：CFB模式下的密钥长度匹配策略  TikTok评论显示延迟如何处理 TikTok评论刷新优化方法  微信网页版扫码登录入口 微信网页版二维码登录入口  C++ typeid如何获取类型信息_C++ RTTI运行时类型识别用法  Python类型检查：优化关联可选属性的Mypy推断策略  QQ邮箱正确登录入口_QQ邮箱官方网站使用地址  C++如何打印当前代码行号与文件名_C++预定义宏FILE与LINE的使用  uc手机浏览器网页版入口 uc浏览器手机版便捷登录首页  Pygame教程：解决用户输入与游戏状态更新不同步问题  Python大型XML文件高效流式解析教程  AO3官方可用镜像 Archive of Our Own网页版最新入口  Tailwind CSS line-clamp 布局问题解析与修复指南  vivo浏览器怎么扫描二维码 vivo浏览器内置扫一扫功能使用方法  AO3最新镜像入口 Archive of Our Own官方平台访问  Yandex官方入口网址 Yandex俄罗斯搜索引擎最新在线地址  2025年云电脑操作系统体验 | 无需本地硬件，随时随地使用高性能PC  cad如何更改注释性对象的比例_cad注释性比例调整方法  c++如何实现一个简单的ECS框架_c++数据驱动设计与游戏开发  极速漫画官方主页网址 极速漫画漫画在线浏览官网链接  如何使 Jest 模拟函数默认抛出错误以提高测试效率  qq游戏网页版直接玩_qq游戏免下载快速入口  淘宝网网页版登录入口 淘宝官方网页版快捷登录  文本文档写html代码怎么运行_文本文档html代码运行步骤【教程】  地铁跑酷免费秒玩入口链接 地铁跑酷小游戏免费秒玩网站  CSS Box Model与弹性按钮：维持布局稳定的动画实践  支付宝解绑银行卡步骤_支付宝如何解除绑定银行卡  Spring Boot内嵌服务器与J*a EE全栈特性：选择与部署策略  Win11怎么开启高性能模式_Windows 11电源计划优化设置  蛙漫2日版入口 WAMAN2(日版)无删减漫画官网链接  Typer应用中灵活处理命令行参数的令牌化与解析  深入理解J*aScript中的B样条曲线与节点向量生成  Tabulator表格中精确实现日期时间排序的指南  LINUX的I/O重定向是什么_深入理解LINUX中 >、>> 与 < 的区别  C#中解析不规范的HTML为XML 常见的坑与解决办法  没有大陆身份证/银行卡如何实名微信？ 亲测有效的几种方法分享  优化 Python 函数中的条件逻辑：解决 if-else 嵌套与参数选择问题  邮编格式怎么匹配地址_根据邮编格式快速匹配详细地址的技巧  浏览器打开即用 美图秀秀网页版入口  在J*a中如何在J*a中使用异常机制记录错误日志_异常日志实践经验  如何使用纯J*aScript判断Input元素是否在特定类容器内  KFC套餐升级怎么获取优惠代码_KFC套餐升级活动与优惠代码获取方法  现代化 SciPy 一维插值：interp1d 的替代方案与最佳实践  Pandas DataFrame：高效添加条件计算列  消息称三星明年 2 月正式发布 HBM4，与 SK 海力士同台竞技