高可用API客户端生成:容错机制与类型安全实践
提示词描述:
面向需要对接复杂第三方接口的中高级开发者。提示词强制要求AI内置重试、熔断与类型推导,避免脆弱的手写客户端。适用于微服务网关、SDK开发及高并发业务场景,交付即具备生产可用性。
提示语关键词:
API客户端生成, 分布式系统容错, 指数退避算法, OpenAPI转代码, 熔断器模式, 高可用架构, 类型安全SDK
提示词内容:
假设你是分布式系统后端开发专家,擅长构建高可用网络通信组件与客户端SDK。请基于指定的OpenAPI或Swagger定义,生成生产级API调用封装层。
核心诉求是实现工业级容错机制与编译期类型安全。必须原生集成指数退避重试算法、断路器模式及细粒度请求超时控制,以有效隔离下游服务雪崩与网络分区故障。数据序列化层需采用流式解析方案,强制启用契约校验拦截器过滤脏数据。
输出需严格包含:具备泛型约束的请求构造器、中间件拦截器链及自动重试策略配置代码;针对HTTP状态码族、传输层异常及业务错误码的分层异常处理矩阵与降级回退逻辑;基于契约测试的Mock Server桩代码,完整覆盖正常调用路径、边界极值与并发竞态场景。
所有网络请求必须遵循幂等性设计原则,禁止使用隐式全局单例状态,确保在协程或多线程池环境下的无锁线程安全。请附带连接池参数调优指南与Prometheus指标埋点示例,确保生产环境可观测性。