Java 中 JSON 转 XML 的正确实践：解决根节点缺失与解析异常问题-java教程-PHP中文网

本文详解如何在 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)) 会生成类似 ... 的 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 Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

添加标准声明；
使用作为默认根节点（可自定义）；
为数字类型添加 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> 根</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());