协议

副标题 / 摘要 Java 与 C# 在运行时层面不直接互通，工程上通常通过协议进行互操作。本文总结常见路径与约束。 目标读者 需要跨语言协作的后端工程师 进行技术选型的团队 关注系统边界与协议设计的架构师 背景 / 动机 JVM 与 CLR 不兼容，直接互操作成本高。 工程上更常见的是“协议互通”，而不是“二进制互通”。 核心概念 协议互通：通过 HTTP/gRPC/消息队列交互 数据契约：用 OpenAPI/Protobuf 约束输入输出 跨平台约束：版本兼容与向后兼容 实践指南 / 步骤 选择跨语言协议（REST/gRPC/消息） 用契约驱动开发（OpenAPI/Protobuf） 在边界层统一错误码与版本策略 建立兼容性测试与回放机制 可运行示例 # 以 REST 为例，跨语言互操作依赖协议而非运行时 curl -X GET "http://localhost:8080/api/v1/users/1" 解释与原理 Java 与 C# 的互操作本质是“协议互通”。 只要协议稳定、数据契约清晰，两端可以独立演进。 常见问题与注意事项 能否直接共享对象模型？ 不现实，语言与运行时差异大。 为什么推荐 Protobuf？ 兼容性好、性能高、跨语言支持完善。 版本升级怎么处理？ 需要兼容策略与灰度发布。 最佳实践与建议 优先契约驱动开发 对协议变更建立评审机制 保持向后兼容与清晰版本号 小结 / 结论 Java 与 C# 的互操作不是“共享运行时”，而是“共享协议”。 协议稳定、契约清晰才是工程关键。 参考与延伸阅读 OpenAPI 规范 gRPC + Protobuf 文档 元信息 阅读时长：6~8 分钟 标签：互操作性、协议 SEO 关键词：Java C# 互操作, gRPC 元描述：说明 Java 与 C# 的互操作方式与约束。 行动号召（CTA） 为你的跨语言服务写一份数据契约，并把它作为版本发布的依据。

副标题 / 摘要 “发送要保守，接收要开放”强调协议实现要严格输出、宽容输入。本文解释其工程价值与风险控制。 目标读者 设计协议或接口的开发者 需要提升系统兼容性的工程师 关注系统稳定性的技术负责人 背景 / 动机 系统之间的协作经常出现版本差异或边界数据。 健壮性原则旨在提高兼容性与稳定性，但也容易掩盖错误。 核心概念 保守发送：严格遵循协议输出 开放接收：尽量容忍输入差异 容错边界：兼容但不放弃校验 实践指南 / 步骤 输出严格遵守协议（字段、格式、范围） 输入做宽容解析（大小写、空白、可选字段） 对异常输入记录告警 明确“可容忍范围”的边界 可运行示例 # 允许输入有空白/大小写差异，但输出严格规范 def parse_level(value: str) -> str: v = value.strip().lower() if v in ("info", "warn", "error"): return v return "info" # 容错默认值 def emit_level(level: str) -> str: # 发送时严格规范 return level.lower() if __name__ == "__main__": print(parse_level(" WARN ")) print(emit_level("WARN")) 解释与原理 开放接收降低了“因为小差异导致系统失败”的概率。 保守发送则保证你不会向外部传播错误数据。 常见问题与注意事项 会不会掩盖错误？ 会，因此需要告警与监控。 开放接收是否意味着接受所有输入？ 不，仍需严格校验关键字段。 何时不应开放接收？ 安全敏感或金融类场景要更严格。 ...

副标题 / 摘要 TCP 是传输层协议，HTTP 是应用层协议。二者的职责与语义完全不同，但经常被混淆。本文用工程视角梳理差异与选型。 目标读者 需要排查网络问题的后端工程师 想理解协议分层的开发者 Web 服务与客户端开发人员 背景 / 动机 很多线上问题都源于“层次混淆”：把 HTTP 的问题当 TCP 处理，或把 TCP 的问题当 HTTP 处理。 理解分层，是定位问题与做技术选型的基础。 核心概念 TCP：可靠、面向连接的字节流传输 HTTP：在传输层之上定义请求/响应语义 分层模型：传输层解决“怎么送到”，应用层解决“送什么” 实践指南 / 步骤 先看连接层：是否能建立 TCP 连接（握手、丢包、重传） 再看应用层：请求是否符合 HTTP 协议（方法、头、状态码） 分层排查：TCP 通了但 HTTP 失败，多半是应用层问题 选型时分清职责：HTTP 可以跑在 TCP 或 QUIC 上 常用诊断命令： # 看 TCP 连接建立 nc -vz host 80 # 看 HTTP 层返回 curl -v http://host/ 可运行示例 先在本机启动一个 HTTP 服务： python3 -m http.server 8000 再用 socket 直接发 HTTP 请求： ...