发生了什么

换电柜是给电动车用户换电池的设备。一台柜子分成若干格口,每个格口放一颗电池:用户把车上没电的电池放进空格口,再从另一个格口取走满电的电池。柜子不是储物箱,它要认识放进去的每一颗电池:柜内程序通过电池的通信接口读出电池编号、型号和状态,判断这颗电池能不能在这里使用,再把结果报给平台;平台据此把这个格口算作有可用电池,用户扫码换电时才会被分到这一格。

正常流程是:电池放进格口,柜内程序按约定好的识别协议与电池通信,读到编号和型号,识别通过,登记为可用;平台侧这个格口显示有电池,换电时可以被选中。

这次是一批电柜刷过柜内程序之后出的问题。这批电柜刷入了一版柜内程序,此后它们对某一型号的电池识别不了:电池放进了格口,柜子却读不出有效的识别结果,也就不把这块电池当成可用电池。现场看到的现象不是报错,而是柜子不认这块电池;同一块电池换到别的柜子上,可能又是正常的。

处置是把电柜程序升级到 V42 版本。这一版对识别代码做了归一化,并优化了电池识别协议,按处置结论升级到这版后问题解决;升级覆盖了多少台电柜、升级后有没有逐型号验证,材料里没有写;受影响的电柜数量、电池数量和持续时长也没有记录。

本质

一句话:柜内程序的电池识别实现和这款电池对不上,程序给不出识别结果,柜子就把这颗电池当成不认识,不能使用。

拆开看:

  1. 识别协议是柜内程序和电池之间的约定。电池怎么应答、型号编码怎么表示、哪些字段必须带,两边要按同一套格式理解。柜子先要读得到,再要读得懂。
  2. 这批电柜刷入的这版程序,识别实现覆盖的是它原本支持的那批型号和报文格式,这款电池不在其中。材料只确认到“识别协议没有覆盖这款电池”这一层,没有细到是帧格式、型号编码还是应答时机不一致。
  3. 程序拿不到有效结果,就把这颗电池判成未知。未知不会抛错,也不会触发告警,只表现为这个格口里没有可用的电池。
  4. 现场因此很难判断:电池是好的,柜子也在线,换电就是用不了。只有把同一块电池换到另一台柜子上对比,才能看出是柜子不认它。
  5. 处置给出的两件事是代码归一化和识别协议优化:前者把识别实现收成一套,让型号与协议的处理只有一处;后者补上这款电池应答的解析。

识别失败被折叠成“这个格口没有电池”,柜子不报错也不告警,现场只能靠换柜对比才能定位。

这类问题失败得很安静:识别失败和格口里本来就没有电池,在调用方看来是同一个结果;只要没有把“读到但不认识”单独记下来,就只能等用户报障。

代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。柜内程序通常不是 Java,这里用 Java 表达识别流程,只说明机制。

错误代码

public class CabinetBatteryRecognizer {

    /** 识别入口:按柜型分流,两种柜型各维护一套识别实现 */
    public BatteryIdentity identify(CabinetType type, byte[] frame) {
        if (type == CabinetType.TYPE_A) {
            return identifyTypeA(frame);
        }
        return identifyTypeB(frame);
    }

    /** 为什么错:这一份实现只按旧型号表匹配,
     * 这款电池的报文能收到,却匹配不到型号,直接判成未知 */
    private BatteryIdentity identifyTypeB(byte[] frame) {
        String model = parseModel(frame);
        if (!LEGACY_MODELS.contains(model)) {
            return BatteryIdentity.unknown();
        }
        return new BatteryIdentity(model, parseSerial(frame));
    }

    /** 调用方把未知当成“柜里没有可用电池”,不报错也不告警 */
    public boolean hasUsableBattery(CabinetType type, byte[] frame) {
        return identify(type, frame).isKnown();
    }
}

修复代码示例

public class CabinetBatteryRecognizer {

    /** 识别入口归一:不再按柜型分流,所有柜子走同一套解析和型号匹配 */
    public BatteryIdentity identify(byte[] frame) {
        ProtocolFrame parsed = ProtocolFrame.parse(frame); // 按报文特征判断协议版本
        String model = MODEL_TABLE.resolve(parsed);        // 型号表只有一份,补入了这款电池
        if (model == null) {
            // 读到报文但型号不认识:单独给出结果,不再并成“没有电池”
            return BatteryIdentity.unsupported(parsed.serial());
        }
        return new BatteryIdentity(model, parsed.serial());
    }

    public boolean hasUsableBattery(byte[] frame) {
        BatteryIdentity id = identify(frame);
        if (id.isUnsupported()) {
            log.warn("battery unrecognized, serial={}", id.serial()); // 留痕,便于按型号排查
        }
        return id.isKnown();
    }
}

修复版沿用同一个识别入口和同一块电池报文,只改了两处:把分柜型的识别实现收成一套、型号表集中维护,并让“读到但不认识”成为可区分、可留痕的结果。柜内程序的实际语言和协议细节材料没有给出,这里不对应真实帧格式。

下次遇到这些场景要警惕

  • 给电柜刷柜内程序前,先列出这台柜子上可能出现哪些电池型号和协议版本,按型号逐项跑一遍识别;刷完再抽每种型号实际放一颗,确认柜子把它登记成可用,而不是只看程序升级成功。
  • 识别结果只有“可用、不可用”两种时,把“读不到”和“读到但不认识”拆成两个结果:后者要留日志、上报平台并计数,否则柜子不认电池这件事只能等用户反馈。
  • 同一段识别逻辑在按柜型、按版本分多份维护时,改型号或改协议要同步到每一份;能收成一套就收成一套,新增型号只改一处,避免刷了哪个版本决定认不认这块电池。
  • 升级电柜程序按批次灰度:先刷少量柜子,统计识别成功率和失败型号,再推全量;全量后回查一批存量电池的识别情况,别把“这台柜子能换电”当成所有型号都恢复。