附录 D：跨语言通信常见问题排查手册

问题	典型现象	排查方法	修复建议
JSON 字段不一致	某语言收到空字段	对照 OpenAPI 契约和日志原文	固定字段命名，不混用 snake_case/camelCase
超时未隔离	网关请求堆积	检查下游耗时和连接池	设置请求级 timeout 和降级
traceId 丢失	日志无法串链	搜索三端日志 traceId	网关注入，所有服务透传
错误码漂移	前端无法判断失败类型	对照错误码表	错误码集中维护，禁止服务自造
数据精度问题	价格小数异常	检查浮点计算与序列化	金额使用整数分或 BigDecimal/Decimal