JDK 版本切换导致 toString() 空指针异常排查与解决

三、问题根因分析

3.1 核心逻辑错误

对日期类型属性（createTime/lastLoginTime）的非空校验逻辑顺序倒置，是导致异常的根本原因：

• 错误逻辑：先调用 DateUtils.format() 方法格式化日期，再判断格式化结果是否为 null，属于'先执行方法、后校验空值'，本质是'踩坑后再判断是否有坑'。
• 关键隐患：当 createTime 或 lastLoginTime 为 null 时，会直接触发 DateUtils.format(null, 格式) 调用，而该调用的行为依赖 JDK 版本，进而导致跨版本兼容性问题。

3.2 JDK 版本差异的影响

DateUtils 底层依赖 JDK 原生日期类（如 SimpleDateFormat），不同版本 JDK 对 null 入参的处理逻辑不同，最终触发异常：

1. 高版本 JDK（JDK 8u200+/JDK 11+）：DateUtils.format(null, 格式) 底层会内置空值校验，直接返回 null，此时代码中的三元表达式可正常执行，返回'空'字符串，无异常抛出。
2. 低版本 JDK（JDK 8u100-/JDK 7）：DateUtils.format(null, 格式) 会直接调用 SimpleDateFormat.format(null)，而低版本 SimpleDateFormat 无空值校验，直接抛出 NullPointerException，且未被捕获，导致代码未走到三元表达式就报错。

3.3 补充说明

单独输出对象非日期属性时无报错，是因为这些属性的空值校验逻辑正确（先判断属性是否为 null，再拼接值），不涉及工具类调用，与 JDK 版本差异无关。

四、解决方法

4.1 核心修复思路

1. 调整空值校验顺序：先校验日期入参（createTime/lastLoginTime）是否为 null，再调用 DateUtils.format() 方法，从源头避免对 null 值执行格式化操作。
2. 优化性能：避免重复调用 DateUtils.format() 方法（原代码非空场景会调用 2 次），提前定义格式化结果变量，仅调用 1 次即可。

4.2 修复后完整代码

@Override public String toString() {
    // 先校验日期入参，再格式化，避免 null 触发异常，同时减少重复调用
    String createTimeStr = (createTime == null) ? "空" : DateUtils.format(createTime, DateTimePatternEnum.YYYY_MM_DD_HH_MM_SS.getPattern());
    String lastLoginTimeStr = (lastLoginTime == null) ? "空" : DateUtils.format(lastLoginTime, DateTimePatternEnum.YYYY_MM_DD_HH_MM_SS.getPattern());
    // 拼接所有属性，使用预处理后的日期字符串
    return "用户 ID:" + (userId == null ? "空" : userId) + ",邮箱:" + (email == null ? "空" : email) + ",昵称:" + (nickName == null ? "空" : nickName) + ",0：直接加 1：同意后加好友:" + (joinType == null ? "空" : joinType) + ",性别 0 女 1 男:" + (sex == null ? "空" : sex) + ",密码:" + (password == null ? "空" : password) + ",个性签名:" + (personalSignature == null ? "空" : personalSignature) + ",状态:" + (status == null ? "空" : status) + ",创建时间:" + createTimeStr + ",最后登录时间:" + lastLoginTimeStr + ",地区名字:" + (areaName == null ? "空" : areaName) + ",地区编号:" + (areaCode == null ? "空" : areaCode) + ",最后离线时间:" + (lastOffTime == null ? "空" : lastOffTime);
}

4.3 可选优化（通用化处理）

为避免重复编写日期空值校验逻辑，可在 DateUtils 工具类中封装通用方法，统一处理空值和格式化异常，提升代码复用性：

4.3.1 工具类新增方法

/**
 * 带空值校验的日期格式化方法
 * @param date 日期对象（可空）
 * @param pattern 格式化模板
 * @return 格式化后的字符串，空值返回'空'，异常返回'格式错误'
 */
public static String formatWithNullCheck(Date date, String pattern) {
    if (date == null) {
        return "空";
    }
    try {
        // 调用原有格式化方法
        return format(date, pattern);
    } catch (Exception e) {
        // 兜底处理格式化异常（如模板错误、日期非法）
        return "格式错误";
    }
}

4.3.2 toString() 简化调用

@Override public String toString() {
    // 直接调用通用方法，简化代码
    String createTimeStr = DateUtils.formatWithNullCheck(createTime, DateTimePatternEnum.YYYY_MM_DD_HH_MM_SS.getPattern());
    String lastLoginTimeStr = DateUtils.formatWithNullCheck(lastLoginTime, DateTimePatternEnum.YYYY_MM_DD_HH_MM_SS.getPattern());
    // 其余属性拼接逻辑与修复后代码一致
    return "用户 ID:" + (userId == null ? "空" : userId) + ",邮箱:" + (email == null ? "空" : email) + ",昵称:" + (nickName == null ? "空" : nickName) + ",0：直接加 1：同意后加好友:" + (joinType == null ? "空" : joinType) + ",性别 0 女 1 男:" + (sex == null ? "空" : sex) + ",密码:" + (password == null ? "空" : password) + ",个性签名:" + (personalSignature == null ? "空" : personalSignature) + ",状态:" + (status == null ? "空" : status) + ",创建时间:" + createTimeStr + ",最后登录时间:" + lastLoginTimeStr + ",地区名字:" + (areaName == null ? "空" : areaName) + ",地区编号:" + (areaCode == null ? "空" : areaCode) + ",最后离线时间:" + (lastOffTime == null ? "空" : lastOffTime);
}

五、问题验证步骤

5.1 根因验证

1. 单独测试工具类调用：在低版本 JDK 环境中，执行 DateUtils.format(null, 格式化模板)，观察是否直接抛出 NullPointerException，验证 JDK 版本差异的影响。
2. 临时重写 toString()：将 toString() 方法简化为 return "测试对象";，输出对象无异常，确认异常由日期格式化逻辑触发。

5.2 修复验证

1. 替换修复后代码，在低版本 JDK 环境中输出对象，无异常抛出，属性值正常展示（空日期显示'空'）。
2. 模拟空值场景：将 createTime/lastLoginTime 设为 null，输出对象仍无异常，格式化结果正确返回'空'。
3. 跨版本验证：在高版本 JDK 环境中复测，确保功能正常，无兼容性问题。

六、总结与通用原则

6.1 问题总结

本次异常本质是'日期格式化空值校验顺序错误'，JDK 版本切换仅为触发条件——低版本 JDK 对 null 入参的容错性更低，暴露了原本隐藏的代码隐患，而非 JDK 版本直接导致异常。

6.2 通用开发原则

1. 工具类调用前必做空值校验：所有第三方工具类或原生 API 调用，需先校验入参是否为 null，再执行方法，避免依赖 JDK 版本的容错行为。
2. 跨 JDK 版本开发需规避版本依赖：避免依赖特定 JDK 版本的底层逻辑（如空值处理、API 行为），显式处理异常和边界场景，提升代码兼容性。
3. 重复逻辑封装复用：同类空值处理、格式化逻辑封装为通用方法，减少重复编码，降低出错概率。

七、附录（可选）

7.1 涉及技术点

• JDK 版本差异：SimpleDateFormat/DateUtils 对 null 入参的处理逻辑。
• toString() 方法：输出对象时默认调用 toString()，异常触发与方法执行路径强相关。
• 空值校验：逻辑顺序对代码稳定性的影响，'先校验、后执行'为最优实践。

7.2 常见问题延伸

若修复后仍报错，可排查：1. DateUtils 依赖版本与低版本 JDK 不兼容，需降级依赖；2. 日期对象存在非法值（非 null 但无法格式化），需在通用方法中增加异常捕获兜底。