如何在并发场景下安全使用AJV Schema进行验证？

我有5年编程经验，但刚接触NodeJS和TypeScript。根据AJV文档，TypeScript中同步使用AJV的常规方式是把AJV#compile的返回值同时当作函数和对象来用（示例代码如下）。我理解validator.errors类似C语言的errno，用来存储和获取错误信息，但如果在两个线程中同时执行验证，错误信息会不会混淆？我了解过AJV的异步验证系统，它基于Promise的API能解决这个问题，但对关键字细节感到困惑，而且这种方式似乎需要修改JSON Schema本身。请问最佳实践是什么？

import { AJV } from 'ajv';
// I am loading my schema from an adjacent file
import * as create_search_response from './create_search.schema.json';

const ajv = new AJV();
const validator = ajv.compile(create_search_response);

function throwUnlessObjectIsValid(obj: any) {
    if (!validator(obj)) {
        // assume at least one error
        throw validator.errors?.pop();
    }
}

核心问题：线程安全风险明确 #

同步编译生成的validator实例不是线程安全的。因为validator.errors是实例级的共享状态，当多个并发调用（比如Node.js异步I/O并发、Worker线程并行执行）同时触发验证时，必然会出现错误信息互相覆盖、混淆的情况——和C语言多线程共用errno的问题本质一致。

最佳实践方案 #

1. 避免共享validator实例（简单同步方案） #

如果要保留同步验证模式，不要复用同一个validator实例，而是为每个验证请求/线程创建独立实例：

import { AJV } from 'ajv';
import * as create_search_response from './create_search.schema.json';

function throwUnlessObjectIsValid(obj: any) {
    const ajv = new AJV();
    const validator = ajv.compile(create_search_response);
    if (!validator(obj)) {
        throw validator.errors?.pop();
    }
}

注意：这种方式每次编译会产生性能开销，适合Schema简单、验证频率低的场景。

2. 使用AJV实例的validate方法（无状态同步验证） #

AJV实例提供的validate方法不会在实例上持久化错误状态，直接返回验证结果，可通过ajv.errors获取错误（但要注意AJV实例本身也非完全线程安全，高并发下仍有风险）：

import { AJV } from 'ajv';
import * as create_search_response from './create_search.schema.json';

const ajv = new AJV();

function throwUnlessObjectIsValid(obj: any) {
    const isValid = ajv.validate(create_search_response, obj);
    if (!isValid) {
        throw ajv.errors?.pop();
    }
}

3. 异步验证（推荐的线程安全方案） #

异步验证的validateAsync API基于Promise，每个验证请求都是独立上下文，天然避免状态共享冲突。普通JSON Schema无需修改，只有当使用异步自定义关键字时才需要调整Schema逻辑，日常场景直接用即可：

import { AJV } from 'ajv';
import * as create_search_response from './create_search.schema.json';

const ajv = new AJV();

async function throwUnlessObjectIsValid(obj: any) {
    try {
        await ajv.validateAsync(create_search_response, obj);
    } catch (err) {
        // err包含具体验证错误信息
        throw err;
    }
}

这种方式既解决了线程安全问题，又能通过Promise的异步特性适配NodeJS的并发模型，是高并发场景的首选。

4. Worker线程隔离（高耗时验证场景） #

如果验证逻辑复杂、耗时高，可将验证逻辑放到Worker线程中，每个线程持有独立的validator实例，完全隔离状态，彻底避免并发冲突。

总结 #

• 低并发、简单Schema：用独立validator实例的同步方式，或AJV的validate方法（注意控制并发）
• 高并发、线程安全需求：优先使用validateAsync异步API，无需修改现有Schema
• 高耗时验证场景：用Worker线程隔离验证逻辑

内容的提问来源于stack exchange，提问作者William Rosenbloom