当 JSON 对象的字段名包含运行时未知的动态部分（如 "highlight:17934390836227915"）时，无法用静态 @JsonProperty 注解映射，应使用 Map 结构接收，再通过键匹配逻辑提取目标数据。
当 json 对象的字段名包含运行时未知的动态部分（如 "highlight:17934390836227915"）时，无法用静态 `@jsonproperty` 注解映射，应使用 `map
在使用 Jackson 解析 JSON 时，若遇到键名本身具有动态结构（例如 "highlight:17934390836227915"、"story:123456789" 等），直接在 POJO 中声明固定字段名或尝试拼接 @JsonProperty("highlight:" + id) 是不可行的——因为 @JsonProperty 值必须是编译期常量，且 Jackson 无法在反序列化前预知键名。
✅ 正确做法是：将该层级建模为 Map<string valuetype></string>，让 Jackson 自动将 JSON 对象的所有键值对映射为 Java 的 HashMap 条目。
以下是一个完整、可运行的示例：
import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;
// 核心数据模型
public class ApiResponse {
@JsonProperty("status")
private String status;
@JsonProperty("data")
private Data data;
// getters & setters (or use Lombok @Data)
}
public class Data {
@JsonProperty("reels")
private Map<String, Reel> reels; // ✅ 动态键名 → Map<String, Reel>
// getter
public Map<String, Reel> getReels() {
return reels;
}
}
public class Reel {
@JsonProperty("id")
private String id;
// getter
public String getId() {
return id;
}
}配合如下 JSON 输入：
立即学习“Java免费学习笔记（深入）”；
{
"status": "success",
"data": {
"reels": {
"highlight:17934390836227915": {
"id": "highlight:17934390836227915"
},
"story:987654321": {
"id": "story:987654321"
}
}
}
}即可安全解析并按需检索：
ObjectMapper mapper = new ObjectMapper();
ApiResponse response = mapper.readValue(jsonString, ApiResponse.class);
// 获取所有 reels 映射
Map<String, Reel> reels = response.getData().getReels();
// 按前缀筛选 highlight 类型 reel
reels.entrySet().stream()
.filter(entry -> entry.getKey().startsWith("highlight:"))
.map(Map.Entry::getValue)
.forEach(reel -> System.out.println("Found highlight: " + reel.getId()));
// 或直接获取指定键（已知 ID 时）
Reel specificReel = reels.get("highlight:17934390836227915");⚠️ 注意事项：
- 不要尝试用正则或字符串替换预处理 JSON（如把
"highlight:xxx"替为"highlight"），这破坏了原始数据语义，易出错且难以维护； - 若需进一步封装（如提供
getHighlightReels()方法），可在Data类中添加辅助方法，保持接口清晰； -
Map默认反序列化为LinkedHashMap，保留原始 JSON 键顺序（Jackson 2.9+）； - 如需类型安全增强，可结合
@JsonAnySetter实现更灵活的动态字段捕获，但对本场景而言Map已是最简、最健壮的方案。
总结：面对非规范、含动态标识符的 JSON 键名，放弃“字段映射思维”，转向“键值映射思维”——Map<string t></string> 是 Jackson 处理此类场景的标准、推荐且生产就绪的解决方案。
