如何修复MongoDB读取时的‘UUID无法转换为String’类转换异常

报错原因 #

你存入MongoDB的userId是UUID对象类型，而非字符串类型。调用document.getString("userId")时，驱动会尝试将存储的UUID对象强制转换为String，这就触发了ClassCastException——因为UUID和String是完全不同的类，无法直接转换。

解决方案 #

1. 直接强转（最简便）

既然存储的是UUID类型，直接用get()方法获取后强转即可，无需通过字符串中转：

UUID userId = (UUID) document.get("userId");

2. 类型安全的getObject方法（推荐）

如果使用的是较新版本的Java Mongo Driver，可以用带类型参数的getObject()方法，避免显式强转的不安全问题：

UUID userId = document.getObject("userId", UUID.class);

3. 兼容多类型场景（如果存在混合存储）

如果不确定userId存储的是UUID还是字符串（比如历史数据有混合情况），可以先做类型判断再处理：

Object userIdObj = document.get("userId");
UUID userId;
if (userIdObj instanceof UUID) {
    userId = (UUID) userIdObj;
} else if (userIdObj instanceof String) {
    userId = UUID.fromString((String) userIdObj);
} else {
    throw new IllegalArgumentException("不支持的userId类型: " + userIdObj.getClass().getName());
}

内容的提问来源于stack exchange，提问作者hb0