本文详解如何在 Java 中安全、可靠地将 JSON 字符串转换为格式规范的 XML，重点解决因缺失合法根元素或非法字符导致的 Unexpected character encountered while parsing value: # 等常见解析错误，并推荐使用成熟库（如 Underscore-java）替代手动拼装 JSONObject 的高风险方式。
本文详解如何在 java 中安全、可靠地将 json 字符串转换为格式规范的 xml，重点解决因缺失合法根元素或非法字符导致的 `unexpected character encountered while parsing value: #` 等常见解析错误，并推荐使用成熟库（如 underscore-java）替代手动拼装 jsonobject 的高风险方式。
在 Java 中将 JSON 转换为 XML 时，一个典型误区是试图通过手动构造嵌套 JSONObject 并调用 XML.toString() 来“添加根节点”。您当前的 JsonToXml 方法存在两个关键缺陷：
JSON 格式被意外破坏：XML.toString(new JSONObject().put("payload", myPayload)) 会生成类似 <payload><name>...</name></payload> 的 XML，但 XML.toString()（来自 org.json 库）不保证输出标准 XML 声明，且对特殊值（如数字、null、嵌套对象）的序列化行为不可控；更严重的是，若原始 JSON 含有顶层注释、BOM 或非 UTF-8 编码内容，new JSONObject(payload) 构造器会在解析阶段直接抛出 Unexpected character encountered while parsing value: # —— 这正是日志中错误的根源（# 常见于 XML 注释 <!-- --> 或 JSON 中误含的非法前导字符）。
XML 结构不满足 Cosmos DB 要求：Cosmos DB 的 XML 输入需为良构（well-formed）文档，必须包含且仅有一个根元素，且不能有多个顶级文本节点。手动拼接易产生无声明、无根、或属性/命名空间缺失等问题，导致后续 DocumentBuilder.parse() 失败。
✅ 推荐方案：使用 Underscore-java 库（轻量、无依赖、专为 Java 函数式转换设计）。它提供稳定、可预测的 U.jsonToXml(json) 方法，自动处理：
立即学习“Java免费学习笔记（深入）”；
- 添加标准 <?xml version="1.0" encoding="UTF-8"?> 声明；
- 使用 <root> 作为默认根节点（可自定义）；
- 为数字类型添加 number="true" 属性以保留类型语义；
- 正确转义特殊字符（<, >, &, ", '）；
- 递归处理嵌套对象与数组。
以下为完整、可直接集成的示例代码：
import com.github.underscore.U;
public String jsonToXml(String jsonInput) {
if (jsonInput == null || jsonInput.trim().isEmpty()) {
throw new IllegalArgumentException("JSON input cannot be null or empty");
}
try {
// 自动添加 root 根节点，生成标准 XML 文档
return U.jsonToXml(jsonInput);
} catch (Exception e) {
throw new RuntimeException("Failed to convert JSON to XML: " + e.getMessage(), e);
}
}调用示例（对应您的测试数据）：
String json = "{\n" +
" \"name\": \"John Smith\",\n" +
" \"sku\": \"20223\",\n" +
" \"price\": 23.95,\n" +
" \"shipTo\": {\n" +
" \"name\": \"Jane Smith\",\n" +
" \"address\": \"123 Maple Street\",\n" +
" \"city\": \"Pretendville\",\n" +
" \"state\": \"NY\",\n" +
" \"zip\": \"12345\"\n" +
" },\n" +
" \"billTo\": {\n" +
" \"name\": \"Me\",\n" +
" \"address\": \"123 Maple Street\",\n" +
" \"city\": \"Pretendville\",\n" +
" \"state\": \"NY\",\n" +
" \"zip\": \"12345\"\n" +
" }\n" +
"}";
String xml = jsonToXml(json);
System.out.println(xml);
// 输出即为标准 XML，含 <?xml ...> 声明和 <root> 根⚠️ 重要注意事项：
-
依赖引入（Maven）：
<dependency> <groupId>com.github.javadev</groupId> <artifactId>underscore-java</artifactId> <version>1.106</version> <!-- 请使用最新稳定版 --> </dependency> -
避免 Document.toString()：您代码中 document.toString() 返回的是 DOM 对象的 toString()（通常是类名+哈希），不是 XML 字符串！应改用 Transformer 输出：
TransformerFactory tf = TransformerFactory.newInstance(); Transformer transformer = tf.newTransformer(); transformer.setOutputProperty(OutputKeys.INDENT, "yes"); StringWriter writer = new StringWriter(); transformer.transform(new DOMSource(document), new StreamResult(writer)); outputItem.setValue(writer.toString());
- Cosmos DB 兼容性：确保生成的 XML 根节点名符合目标容器 Schema 要求（如需 payload 而非 root，可用 U.jsonToXml(json, "payload") 指定自定义根名）。
综上，放弃手动 JSONObject 拼装，采用 Underscore-java 的 U.jsonToXml() 是最简洁、健壮、符合生产环境要求的解决方案。它从根本上规避了字符解析异常、根节点缺失、编码不一致等陷阱，让 JSON→XML 转换真正成为一行可靠的函数调用。
