开发避坑指南(38)：DOM4J解析XML文件报错“前言中不允许有内容”的解决方案

原创于 2025-08-26 22:24:37 发布 · 494 阅读

8 ·

CC 4.0 BY-SA版权

文章标签：

#java

避坑指南专栏收录该内容

71 篇文章

订阅专栏

报错信息

org.dom4j.DocumentException: Error on line 1 of document  : Content is not allowed in prolog. Nested exception: Content is not allowed in prolog.
	at org.dom4j.io.SAXReader.read(SAXReader.java:482)
	at org.dom4j.DocumentHelper.parseText(DocumentHelper.java:278)

中文错误信息：

org.dom4j.DocumentException: Error on line 1 of document  :前言中不允许有内容.

报错代码

try {
    Document document = DocumentHelper.parseText(xmlContext);
} catch (Exception e) {
    e.printStackTrace();
}

异常分析

该错误通常由XML文件格式问题引起，UTF-8编码的XML文件若包含BOM头（EF BB BF字节序标记），会导致解析器识别异常。

解决办法

Java代码中通过BOMInputStream过滤XML文件中的BOM头。参考代码如下：

try {
    InputStream in = new ByteArrayInputStream(xmlStr1.getBytes());
    BOMInputStream bomIn = new BOMInputStream(in, false);
    cleanXml = IOUtils.toString(bomIn, StandardCharsets.UTF_8);
    xmlStr1 = cleanXml;
}finally {
    //关闭流
}