发生了什么
网点是平台对外提供服务、需要日常维护的实体场所。系统给每个网点保存一份档案,档案里有营业时间,记录每天几点开门、几点关门。运营在网点管理页面维护网点的运维信息,也就是网点日常运行维护相关的记录;提交时后端会读取该网点的档案,把营业时间的字符串转换成时间对象,再和运维信息一起处理。
正常流程下,档案里的营业时间是当天之内的具体时刻,比如 22:00,转换不会出问题,提交能正常完成。
出问题的是一个早期录入的老网点。它的关门时刻在库里存成了 24:00,含义是营业到当天结束。运营填写这家网点的运维信息并提交时,后端读取营业时间、调用 LocalTime.parse 解析,遇到 24:00 直接抛出异常,请求中断,页面只显示网络错误。运营反复重试结果一样,从提示里也看不出是数据问题。
从原因看,只有营业时间结束值为 24:00 的存量网点会走到这条失败路径;记录没有给出受影响网点的数量,也没有说明这些网点的运维信息最终是改数据、换入口还是其他方式补录的。
本质
-
LocalTime的合法范围。Java 的LocalTime表示一天内的时刻,只能取 00:00 到 23:59:59 之间的值,可带纳秒小数;LocalTime.parse默认按 ISO 本地时刻格式解析,小时部分不允许 24。24:00 是“到当天结束”的常见业务写法,但它不是一个合法的LocalTime值。 -
写入和读取对格式的假设不一致。老网点建档时接受并保存了 24:00;读取代码却假定所有存量值都是标准时刻。中间没有归一化,也没有对历史写法做兼容。
-
异常直接冒到接口层。解析抛出的
DateTimeParseException没有被转换成业务提示,请求失败,页面显示的是网络错误。于是数据问题看起来像网络问题,运维从提示里看不出是哪条数据出的错。
历史数据不会因为新代码上线就自动变成合法值,读取边界必须能处理存量里的旧写法。
处理方式是新增一个转换方法,在解析前把 24 点转换成 23:59,再交给后续流程。要注意 23:59 与 24:00 差一分钟:如果这个时间还参与营业时长计算或“是否已打烊”判断,需要确认这一分钟不会让边界结论翻转;同时要决定归一化只放在读取侧,还是写入时也统一,避免同一字段出现两种含义。记录未说明该改动是否已上线、覆盖了哪些读取入口。
下面两段是脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。
错误代码
// 提交运维信息时,先读取网点档案里的营业时间
public void saveMaintainInfo(long stationId, MaintainForm form) {
Station station = stationMapper.selectById(stationId);
LocalTime open = toLocalTime(station.getOpenTime());
LocalTime close = toLocalTime(station.getCloseTime());
maintainService.save(stationId, form, open, close);
}
private LocalTime toLocalTime(String hhmm) {
// 为什么错:直接按 ISO 本地时刻解析,
// 老网点存量值 "24:00" 超出 00:00~23:59 的合法范围,
// 这里抛 DateTimeParseException,整次提交失败
return LocalTime.parse(hhmm);
}
修复代码示例
private static final LocalTime END_OF_DAY = LocalTime.of(23, 59);
private LocalTime toLocalTime(String hhmm) {
// 为什么这样改:只兼容历史写法 24:00,
// 把它收敛为当天最后一个可表示时刻;
// 24:30 之类仍交给严格解析,继续暴露为脏数据
if (hhmm != null && hhmm.startsWith("24:00")) {
return END_OF_DAY;
}
return LocalTime.parse(hhmm);
}
如果这个时间在别处仍按 24:00 的语义使用,归一化只放在读取侧,不要顺手回写数据库,避免影响其他消费者。
下次遇到这些场景要警惕
- 时间字段来自历史数据:先抽样看实际存储的取值,确认是否出现 24:00、带秒、空串等写法,再用这些值跑一遍读取和保存,观察失败时页面提示的是哪类错误。
- 用标准解析器直接解析业务时间:先确认它的取值范围,24 点、单数字小时这类写法不在标准范围内;构造这些边界值,断言解析结果和失败时的错误信息。
- 把 24:00 归一到 23:59:确认该字段是否参与营业时长、是否已打烊的判断,差一分钟会不会让结论翻转,并决定归一化只放读取侧还是写入时也统一。
- 兼容存量写法后:用一家结束时间为 24:00 的老网点和一家正常网点分别提交运维信息,确认老网点能保存、库里原值是否被改写,以及错误提示能否把网络故障和数据问题区分开。