GeoXMind

互操作性依赖共享语义

说明系统交换数据只是起点，协议语义、标识、版本和错误处理共同决定能否协同。

互操作性依赖共享语义

两个系统能够建立连接，只说明网络和协议的最低条件成立。真正的互操作还要求双方对消息含义、状态变化、错误处理和生命周期形成足够一致的理解。格式兼容而语义不一致，往往比直接报错更危险。

语法一致不等于含义一致

JSON、XML 或 Protocol Buffers 可以约束结构，却不能自动说明“更新时间”使用哪个时区、“删除”是软删除还是永久移除、“坐标”采用什么参考系。字段名称相同，也可能在取值范围、单位和缺失含义上不同。

接口契约应说明单位、枚举、可空性、标识符范围和状态转换。对于空间数据，还要明确坐标参考系、轴顺序和几何有效性；对于时间数据，则要区分事件时间、处理时间和展示时区。这些语义比传输格式更决定交换结果。

协议规定交互过程

互操作不仅是请求和响应的字段。调用是否幂等、缓存何时有效、并发更新如何检测、分页是否稳定、失败后能否重试，都会影响双方行为。HTTP 语义为方法、安全性、条件请求、状态码和缓存提供共同基础，但应用仍需明确如何使用这些约定。

例如把所有失败都返回成功状态并在正文中附错误文字，会削弱代理、监控和客户端的通用处理能力。反过来，仅依靠状态码而没有领域错误信息，也难以指导调用者纠正输入。协议层与领域层需要各自承担清晰职责。

演进必须保护已有调用者

服务与调用者通常不能同时升级。新增可选字段、扩展枚举或改变默认值，都要考虑旧版本如何解释。消费者能够忽略未知字段，不代表可以接受未知业务状态；生产者也不能假定所有客户端立刻采用新语义。

兼容演进需要公布契约、变更窗口和弃用路径。对关键集成，可用消费者驱动契约或跨版本测试验证真实交互。版本号只能标识边界，不能替代对差异的说明和迁移安排。

标识与错误要跨边界追踪

资源标识必须在系统之间保持稳定，避免把本地自增编号当作全球含义。请求标识、幂等键和事件编号有助于识别重复传输，也使一次业务动作能够跨越服务日志被追踪。

错误模型应区分临时失败、永久拒绝和状态冲突。调用者只有知道失败类别，才能决定重试、补偿还是交由人工处理。未经约束的自动重试会重复创建资源，模糊错误则会把数据不一致拖到更晚才暴露。

互操作需要持续验证

接口文档过时后，共享语义就会退化为口头约定。机器可读模式、示例、契约测试和生产指标应相互补充。测试要覆盖正常交换、边界值、未知字段、重复消息和部分故障，并验证双方对结果的解释一致。

SEI 将互操作视为需要场景化推理的质量属性：某个外部系统在特定环境发起交换，系统要在限定条件下完成信息传递并保持正确解释。把参与方、语义和失败响应写清楚，才能判断互操作是否真正成立。

资料依据