发生了什么
设备会上报温度等心跳数据,服务端读取这些数据后才能继续处理。一次解析组件升级后,部分旧设备上报的数据突然读不出来了。
出现错误后,首批发布节点被移出服务,随后终止了发布。
本质
设备和服务端对温度数字的表示方式没有完全对齐:旧设备用一个很大的正整数表示负温度,但服务端原来用的整数类型装不下这个数。
以前没报错,是因为旧版解析组件会把超出范围的部分截掉;升级后,新版遇到这种数字会直接报错。
数据没变,读取它的组件处理方式变了,原来隐藏的问题就暴露出来。
升级前能读进去,不代表原来读出的值就是正确的。
处理方式包括换用能接收更大数值的类型,并联系设备侧升级。但“能装下原始数字”和“能正确还原温度”是两件事,完整转换的验证状态待确认。
错误代码
// Java后端:把设备温度直接解析为有符号32位整数。
Integer value = json.getObject("temperature", Integer.class);
// 旧设备的 uint32 报文可能超过 Integer 上限,新解析库会报错。
修复代码示例
// 仅适用于协议明确约定:用 uint32 编码 int32 温度。
long raw = json.getLongValue("temperature");
if (raw < 0L || raw > 0xFFFF_FFFFL) {
throw new IllegalArgumentException("温度报文超出协议范围");
}
int signedValue = (int) raw; // 按低32位还原有符号整数
// 后续继续按设备协议规定的单位和倍率换算。
用 long 接住报文,解决数值装不下的问题;根据明确的设备编码协议转换,才能得到正确的有符号值。不能只把 Integer 改成 Long,就直接把大正数当温度展示;协议不明时应先确认。
下次遇到这些场景要警惕
- 升级读取数据的组件:拿新旧设备实际报文分别测试,既比较是否报错,也比较读出的数值。
- 两端对数字的表示不同:明确正负号、数值范围和单位,检查最终温度符合设备约定。
- 只在少量节点先发布:检查测试和观察覆盖了旧设备数据,出现解析错误时能及时停止继续发布。