客户端和服务端各自开发时，最常见的问题是字段名称、枚举值和可空性不一致。

可以先维护 OpenAPI 文档，再使用工具生成 Java DTO 或客户端接口。CI 中加入契约测试，检查响应结构是否发生不兼容变化。

重点检查：

• 字段是否突然变成必填；
• 枚举是否删除旧值；
• 时间格式是否改变；
• 分页字段是否保持一致；
• 错误响应是否统一。

契约测试不能替代真实设备测试，但能提前发现大量联调问题。