应用基础设施的调用链错误设计契约先于实现接口一旦被多个调用方依赖字段和错误语义就成了协作边界。兼容策略需要早于实现确定。明确请求字段、必填条件、幂等要求和响应语义。请求 ID、提示词版本、检索结果与采样规则 中跨服务数据要有版本策略新增字段可忽略删除或改义需给兼容窗口。错误让调用方能处理区分参数无效、权限不足、资源不存在、暂时不可用和内部异常。对可重试错误给出稳定类别响应里不返回密钥或内部地址。执行细节把空值、幂等范围和错误类别写入契约。分别以旧客户端/新服务、新客户端/旧服务跑兼容测试破坏性变更保留弃用与迁移窗口。为错误码和字段演进提供示例请求调用方才能正确实现分支。契约检查应在发布前运行并在发现不兼容时阻止扩大范围而不是仅在文档中提醒。