发生了什么

换电柜的每个格口里放着一颗电池,设备会周期性把格口状态和电池编号上报给服务端。服务端收到报文后分两步处理:先把报文文本解析成 JSON 对象,再把对象绑定到业务对象上。绑定电池编号时,字段上挂着一个自定义解码器,负责把 16 进制文本(形如 A1B2C3D4E5F6)转成业务系统使用的数字编号;解码要求文本至少有 6 个字节,长度不够就认为不是合法编号,用一个全零的占位编号顶上,让流程继续往下走。

一次依赖升级把服务使用的 JSON 解析库换到了新版本。升级之后,同一个柜子开始出现电池识别异常:柜子本身、格口位置、固件都没有变化,只有个别电池的编号变成了全零占位。把这颗电池换到另一个格口,问题照样出现;同一个柜子里的其他电池一切正常。

确认到的范围是电池编号识别本身:异常只出现在编号形态满足特定条件的电池上,记录里影响订单数为 0。

本质

关键在于:报文里的电池编号本来是带引号的字符串,但引号在解析中途丢了,值在到达解码器之前就已经不是原来那串文本了。

第一步解析报文文本时完全正常,此时电池编号就是字符串,直接取值能拿到原样文本。

第二步把 JSON 对象绑定到业务对象时出了问题。绑定用的是“从 JSON 对象上按某个类型取值”的方式,而电池编号字段挂着自定义反序列化器。这个接口要求传入一个词法分析器,可此时解析库手里只有一个 Java 字符串,没有原始报文了。为了凑出词法分析器,它把这串文本重新拼成一段 JSON 文本再解析一遍,拼接时对“看起来像数字”的字符串省略了引号。

于是 1234E5678 被去掉引号,当成科学计数法里的数字读了进来,取回的文本也变成数字的写法:把 1E3 走同一条路径,读回来是 1E+3,多出来的加号说明中间确实生成过数字对象,而不是对字符串做了截断。原本 12 个字符的 16 进制串因此变短,字节数不足 6,解码器返回空,代码兜底成全零占位编号。

命中与否只取决于编号形态:是否含 E、且其余字符恰好都是 0-9。含 A、B、C、D、F 的编号构不成数字,引号保留,值不变;不含 E 的编号也不会被改写。这解释了为什么同一柜子只有一颗电池出问题、换格口依然复现——与柜型、格口、城市、固件版本都无关。

决定性证据是解码器内打印的词法分析器状态:问题电池的值被判成浮点数(LITERAL_FLOAT),对照电池的值仍是字符串(LITERAL_STRING)。同一份代码、同一个入口、同一次运行,差别只在引号有没有丢。

字符串被当成数字重新解析,值在业务代码拿到它之前就被改写了,而且全程不报错。

修复方向是:不让字符串值走“重新拼文本再解析”这条路,改为直接按原始报文一次性绑定业务对象,或在解码器里明确要求当前 token 是字符串;解码失败时不要静默兜底成全零编号,而是保留原值并告警。修复上线状态待确认。

错误代码

// 电池编号字段挂的自定义反序列化器(示意)
public class BatteryIdDeserializer implements ObjectDeserializer {
    @Override
    public Object deserialze(DefaultJSONParser parser, Type type, Object fieldName) {
        // 为什么错:这里的词法分析器来自“字符串值重新拼出的 JSON 文本”,
        // 值形如 1234E5678 时引号已被省略,读到的是数字,不是原来的 16 进制串
        String raw = parser.getLexer().stringVal();
        String batteryNo = decodeHex(raw);                 // 字节数不足 6 时返回 null
        // 为什么错:解码失败直接兜底成全零,异常被吞掉,下游无从发现
        return batteryNo == null ? FALLBACK_NO : batteryNo;
    }
}

// 调用侧:先解析成 JSON 对象,再按裸 Class 绑定业务对象
JSONObject json = JSON.parseObject(payload);
// 为什么错:第二个参数是裸 Class,字符串字段会被重新序列化一次再解析
GridInfoReport report = json.getObject("data", GridInfoReport.class);

修复代码示例

// 调用侧:从原始报文一次性绑定,反序列化器拿到的是原始文本
GridInfoReport report = JSON.parseObject(payload, GridInfoReport.class);

public class BatteryIdDeserializer implements ObjectDeserializer {
    @Override
    public Object deserialze(DefaultJSONParser parser, Type type, Object fieldName) {
        // 先确认当前 token 真的是字符串,而不是被改写过的数字
        if (parser.getLexer().token() != JSONToken.LITERAL_STRING) {
            throw new IllegalArgumentException("电池编号必须是字符串");
        }
        String raw = parser.getLexer().stringVal();
        String batteryNo = decodeHex(raw);
        if (batteryNo == null) {
            // 不兜底:保留原始值并告警,避免错误编号继续流向下游
            alert.warn("battery.id.decode.fail", raw);
            throw new IllegalArgumentException("电池编号解码失败");
        }
        return batteryNo;
    }
}

parseObject(payload, GridInfoReport.class) 表示直接从原始报文绑定业务对象;token() 判断用来拦住“值已经不是字符串”的情况。如果业务上允许,还可以把上报原值一并记下来,便于事后比对。这段修复是从机制推导出的可选做法,不代表实际提交。

下次遇到这些场景要警惕

  • 升级 JSON 或序列化库:拿线上真实报文回放,逐个比对编号、金额、编码这类“看着像数字”的字符串字段升级前后的取值,不能只确认不报错。
  • 字段挂了自定义反序列化器:确认取值是从原始报文的 token 读,还是从已解析的对象上二次取值;后者会让字符串再经历一次数字判定。
  • 解码或校验带兜底值:检查兜底是否静默。失败时应告警并保留原始值,否则占位值会把错误掩盖成“正常数据”。
  • 排查复现范围:按值的形态分组验证(含 E、纯数字、含其他字母),而不是按柜型、格口、城市分组,否则会把系统性缺陷误判为单点硬件问题。