![如何在 JSON 序列化中避免顶层方括号（[]）而保持对象列表的灵活构建](https://img.php.cn/upload/article/001/246/273/179237423754459.jpg)
当使用 Jackson 将多个对象序列化为 JSON 字符串时，若直接序列化 List，结果会自动包裹方括号形成 JSON 数组；要输出无顶层数组、仅由逗号分隔的 JSON 对象序列（如用于拼接查询参数），需通过封装容器类绕过默认集合序列化行为。
当使用 jackson 将多个对象序列化为 json 字符串时，若直接序列化 `list
在实际开发中（尤其是构造 REST API 查询参数或批量消息体时），我们常需要将多个结构化对象拼接成一串以英文逗号分隔的 JSON 对象序列，例如：
{"items":[{"itemsCode":"item1","isAvailable":false}],"isActive":false},{"items":[{"entryCode":"item2","isSelected":true}],"isActive":false}⚠️ 注意：这不是标准 JSON 数组（不以 [...] 包裹），因此不能直接对 List<items></items> 调用 ObjectMapper.writeValueAsString() —— Jackson 会严格遵循 JSON 规范，将 List 序列化为数组，必然产生外层 []。
✅ 正确解法：引入容器类 + 自定义序列化逻辑
Jackson 默认无法“取消”集合的数组语义，但我们可以不序列化 List 本身，而是将其作为字段嵌入一个 POJO 容器中，再按需提取其 JSON 表示——但注意：本例目标并非生成合法 JSON 文档，而是生成可拼接的 JSON 片段字符串。因此更推荐以下两种专业方案：
方案一：手动拼接（推荐用于查询参数场景）
适用于生成非标准 JSON 片段（如 URL 查询值、日志拼接等），简洁可控：
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
ObjectMapper mapper = new ObjectMapper();
List<Items> itemsList = new ArrayList<>();
// 在 for 循环中构建并添加
for (/* your data source */) {
List<Item> itemEntries = buildItemEntries(...);
Boolean isActive = computeIsActive(...);
itemsList.add(new Items(itemEntries, isActive));
}
// 将每个对象单独序列化，再用逗号连接
String result = itemsList.stream()
.map(item -> {
try {
return mapper.writeValueAsString(item);
} catch (JsonProcessingException e) {
throw new RuntimeException("JSON serialization failed", e);
}
})
.collect(Collectors.joining(","));
// 输出：{"items":[...],"isActive":false},{"items":[...],"isActive":false}✅ 优势：无需修改 POJO 结构，语义清晰，完全符合需求；
❌ 注意：确保 Items 类字段命名与 JSON 键一致（建议启用 @JsonProperty 或配置 mapper.enable(SerializationFeature.WRITE_ENUMS_USING_TO_STRING) 等增强可读性）。
方案二：使用 JsonGenerator 流式写入（高性能进阶）
适合大数据量、低内存开销场景：
ObjectMapper mapper = new ObjectMapper();
StringWriter writer = new StringWriter();
JsonGenerator gen = mapper.getFactory().createGenerator(writer);
gen.writeStartArray(); // 可选：若仍需数组语义
for (Items item : itemsList) {
mapper.writeValue(gen, item); // 每次写入一个完整 JSON 对象
}
gen.writeEndArray();
gen.close();
// 若需去除外层 []，取 substring：
String rawJsonObjects = writer.toString().substring(1, writer.toString().length() - 1);⚠️ 风险提示：手动裁剪 JSON 字符串存在安全隐患（如嵌套数组/对象含 ] 会导致截断错误），不推荐用于不可信数据源。
? 总结与最佳实践
-
不要试图让
List<t></t>直接序列化为无[]的字符串 —— 这违背 JSON 规范，Jackson 不支持也不应支持； -
明确使用场景：若用于 HTTP 查询参数（如
?data={...},{...}），方案一（流式map + join）最安全可靠； -
POJO 建议优化：为避免字段名混淆（如
isBoolean→isActive），应在Items类中使用语义化命名并配合@JsonProperty注解； -
编码健壮性：始终捕获
JsonProcessingException，并在循环中避免重复创建ObjectMapper（它是线程安全且开销较大，应复用单例实例）。
最终，核心原则是：用正确的抽象表达意图——你需要的是“JSON 对象序列”，而非“JSON 数组”，那就别用 List 作为顶层序列化目标，而应通过组合或流式处理达成目的。
