yup 本身不提供开箱即用的“自动剥离无效字段”功能，但可通过捕获验证错误并手动剔除对应路径的键值，实现安全、可控的数据净化。
yup 本身不提供开箱即用的“自动剥离无效字段”功能，但可通过捕获验证错误并手动剔除对应路径的键值，实现安全、可控的数据净化。
在表单处理、API 请求清洗或配置合并等场景中，我们常需要“尽力而为”地保留合法字段，而非因单个字段校验失败就拒绝整个对象。Yup 的 validate() 方法默认在遇到任何校验失败时抛出 ValidationError（拒绝 Promise），但它同时提供了完整的错误信息（包括每个失败字段的 path），这正是实现智能剥离的关键。
以下是一个健壮、可复用的剥离方案：
import { object, string, number, date, ValidationError } from 'yup';
const userSchema = object({
name: string().required(),
age: number().required().positive().integer(),
email: string().email(),
website: string().url().nullable(),
createdOn: date().default(() => new Date()),
});
// ✅ 安全剥离函数：返回仅含通过校验字段的对象
async function stripInvalidFields<T>(schema: any, data: unknown): Promise<T> {
try {
// 若全部字段有效，直接返回标准化后数据（含默认值、类型转换等）
return await schema.validate(data, { abortEarly: false });
} catch (err) {
if (!(err instanceof ValidationError)) throw err;
// 浅拷贝原始输入（注意：不深克隆嵌套对象）
const stripped = { ...data } as Record<string, unknown>;
// 遍历所有错误，按 path 删除对应字段（支持嵌套如 "profile.age"）
err.inner.forEach(({ path }) => {
if (path && typeof stripped === 'object' && stripped !== null) {
const keys = path.split('.');
let target: any = stripped;
// 逐级访问至倒数第二层
for (let i = 0; i < keys.length - 1; i++) {
if (target && typeof target === 'object' && keys[i] in target) {
target = target[keys[i]];
} else {
return; // 路径不完整，跳过
}
}
// 删除最后一级属性
delete target[keys[keys.length - 1]];
}
});
return stripped as T;
}
}
// 使用示例
const input = {
name: 'jimmy',
age: -1, // ❌ 无效：非正整数
email: 'invalid-email', // ❌ 无效：格式错误
website: 'https://example.com', // ✅ 有效
};
stripInvalidFields(userSchema, input).then(console.log);
// 输出：{ name: 'jimmy', website: 'https://example.com' }⚠️ 重要注意事项：
- abortEarly: false 必须启用，否则 ValidationError.inner 仅包含首个错误，导致其他无效字段无法被剥离；
- 该方案不执行类型转换或默认值填充（如 createdOn 不会自动补入），若需保留 Yup 的标准化能力（如日期解析、字符串 trim），建议改用 .cast() 配合手动校验，或先 .validate(..., { stripUnknown: true })（仅对 object() 的 unknown() 字段生效，不适用于已声明字段）；
- 对于深层嵌套对象，上述 delete 逻辑已支持点号路径（如 "address.city"），但不处理数组索引（如 "users.0.name"），如需支持，需扩展路径解析逻辑；
- 生产环境建议封装为工具函数，并添加 TypeScript 类型守卫（如 isPlainObject）以增强鲁棒性。
总结：Yup 的错误对象是剥离策略的基石——它不是障碍，而是精准控制数据净化粒度的接口。合理结合 ValidationError.inner 与路径操作，即可在强校验与柔性容错之间取得最佳平衡。
