当从 grpc dynamicmessage 中获取嵌套字段时，若目标字段为 repeated 类型，其实际返回值是不可修改的 list（如 `collections$unmodifiablerandomaccesslist`），直接强转为 `message` 会触发 classcastexception；应先判断并转为 `list>`，再逐项安全访问。
在使用 Protocol Buffers 的 DynamicMessage 解析 gRPC 响应时，一个常见误区是假设所有嵌套字段都以单个 Message 实例形式存在。但根据 .proto 定义，若字段声明为 repeated（例如 repeated MyNestedType field2 = 2;），那么即使响应中只包含一个元素，message.getField(fieldDescriptor) 返回的仍是 List
因此，以下代码会失败：
Object subMessage = message.getField(
message.getDescriptorForType().findFieldByName("field2")
);
Message sub = (Message) subMessage; // ❌ ClassCastException!✅ 正确做法是：先检查字段是否为 repeated 类型，再按 List 处理：
FieldDescriptor field2Desc = message.getDescriptorForType().findFieldByName("field2");
Object field2Obj = message.getField(field2Desc);
if (field2Desc.isRepeated()) {
@SuppressWarnings("unchecked")
List field2List = (List) field2Obj;
if (!field2List.isEmpty()) {
Message firstField2 = field2List.get(0); // ✅ 安全获取首个嵌套 Message
// 继续解析 nested_key_1（假设它在 firstField2 中是单值字段）
FieldDescriptor nestedKey1Desc = firstField2.getDescriptorForType()
.findFieldByName("nested_key_1");
if (nestedKey1Desc != null && !nestedKey1Desc.isRepeated()) {
Object nestedValue = firstField2.getField(nestedKey1Desc);
System.out.println("nested_key_1 = " + nestedValue);
}
}
} else {
// 非 repeated 字段：可安全强转为 Message
Message sub = (Message) field2Obj;
// ... 后续处理
} ⚠️ 注意事项：
- 不要依赖 instanceof Message 判断——repeated 字段永远不是 Message 实例；
- 使用 fieldDescriptor.isRepeated() 是最可靠的方式识别重复字段；
- DynamicMessage.getField() 对 repeated 字段返回的是 List>，其中每个元素才是 Message（或基本类型）；
- 若需遍历所有重复项（如 key3 和 key4 均为 repeated），应统一用 for (Message item : list) 迭代；
- 在生产环境中，建议封装通用工具方法（如 getSingleMessageField / getRepeatedMessageField），提升健壮性与可维护性。
通过明确区分字段的 cardinality（单值 vs 重复），即可彻底避免 ClassCastException，并安全、灵活地解析任意结构的 DynamicMessage。
