结构化提示词里给示例字段加校验规则，响应 schema 和 sample 终于不打架了
将示例字段的校验规则直接写入结构化提示词，强制模型在生成响应示例前逐字段对照 schema 约束，可根治 API 文档中示例与 schema 不一致的问题。通过设置 field_validation_rules 和 validation_check 输出结构，把校验动作显式化，实测可将一致性提升至 100%。
标签: #JSON Schema
共 3 篇文章
Mock 数据骗过了测试，我们在拦截层补了一层契约校验才把假请求管住
前端测试中 mock 数据与真实接口脱节是常见隐患，典型案例显示三层验证仍未能阻止因字段类型不一致导致的生产事故。问题根源在于 mock 仅验证前端逻辑，不校验数据结构真实性。解决方案是在 MSW 等拦截层引入 JSON Schema 自动契约校验，强制 mock 数据与接口定义同步，使测试在第一时间暴露类型错误、边界缺失等问题。该机制提升了反馈循环效率，重构了前后端协作信任，但需注意 schema 维护成本和适用范围。
用 TypeScript 类型做接口文档，怎么让它跟后端返回保持同步
解决前后端接口类型不一致的核心方案：将 TypeScript 类型定义作为唯一真相来源，通过工具链实现自动化校验。具体做法是用 ts-json-schema-generator 将类型编译为 JSON Schema，再在 CI 中用 Ajv 校验实际响应数据。也可从后端代码直接生成前端类型，或用 OpenAPI 作为中间契约，配合 openapi-diff 检测破坏性变更。针对泛型、联合类型等复杂场景需注意工具版本和配置优化。