XML解析报“Content is not allowed in prolog”错误通常因UTF-8 BOM（EF BB BF）导致，BOM违反XML规范且被解析器误读为非法首字符；可通过编辑器转存为无BOM格式、Java用BOMInputStream跳过、C#启用StreamReader自动检测、或Linux用tail剥离解决。
如果您尝试解析一个XML文件，但解析器报出“Content is not allowed in prolog”或类似“前言中不允许有内容”的错误，则很可能是该文件以UTF-8编码保存时携带了BOM头（EF BB BF）。以下是针对此问题的多种处理方式：
一、理解UTF-8 BOM对XML解析的影响
UTF-8 BOM是位于文件开头的三个字节EF BB BF，其本意是标识编码，但XML规范明确不推荐在UTF-8中使用BOM。多数XML解析器（如Dom4j、Xerces、JDOM、.NET的XmlDocument）会将BOM误读为文档首字符，导致解析器在XML声明前发现非法字符，从而触发“prolog error”。该错误与中文乱码无关，而是结构层面的解析失败。
1、BOM不是XML合法内容，违反XML 1.0规范中“文档必须以XML声明或根元素开头”的要求；
2、十六进制查看文件开头若显示ef bb bf，即可确认存在UTF-8 BOM；
3、使用FileReader或未识别BOM的StreamReader直接读取，必然将BOM转为Unicode字符并混入字符串，破坏XML格式完整性。
二、使用文本编辑器移除BOM（手动修复）
该方法适用于开发调试阶段快速验证问题根源，无需编码介入，操作直观可靠。
1、用Notepad++打开XML文件，点击菜单栏“编码” → 选择“转为UTF-8无BOM格式”；
2、用VS Code打开文件，右下角点击当前编码名称（如“UTF-8”），选择“通过编码重新打开” → “UTF-8”；若显示“UTF-8 with BOM”，则选“另存为”并在保存对话框中勾选“保存时不包含BOM”；
3、用EditPlus打开文件，进入“工具”→“首选项”→左侧选“文件”，右侧“UTF-8 signature”下拉框设为Always remove signature，保存即生效。
三、Java中安全读取带BOM的XML文件
核心原则是避免使用FileReader，改用可探测BOM的字节流+显式编码组合，确保BOM被跳过而非解析。
1、引入Apache Commons IO库，使用BOMInputStream包装原始FileInputStream；
2、调用bomIn.getBOMCharsetName()获取真实编码名（如"UTF-8"）；
3、构造InputStreamReader时传入该编码名，再交由DocumentBuilder.parse()或DocumentHelper.parseText()处理；
4、若无法引入第三方库，可手动读取前3字节：若等于(byte)0xEF, (byte)0xBB, (byte)0xBF，则跳过这3字节后再创建String或InputStreamReader。
四、C#中处理XML BOM的正确方式
.NET框架提供原生支持，关键在于启用BOM自动检测机制，而非依赖硬编码UTF-8。
1、使用StreamReader构造函数时，第二个参数detectEncodingFromByteOrderMarks必须设为true；
2、示例：new StreamReader(fileStream, Encoding.UTF8, true)；
3、随后用XDocument.Load()或XmlDocument.Load()传入该StreamReader实例；
4、严禁使用File.ReadAllText(path, Encoding.UTF8)——它不识别BOM，会把EF BB BF当作三个非法字符嵌入字符串。
五、命令行快速检测与剥离BOM（Linux/macOS）
适用于CI/CD流水线或批量处理场景，可在脚本中集成，实现自动化清理。
1、检测是否存在BOM：hexdump -C your.xml | head -n 1，观察输出是否以00000000 ef bb bf开头；
2、剥离BOM生成新文件：tail -c +4 your.xml > no_bom.xml（精确跳过前3字节）；
3、验证结果：xmlstar --version后执行xmlstar -t -o "OK" -i no_bom.xml，若无报错即成功；
4、批量处理所有XML：for f in *.xml; do tail -c +4 "$f" > "clean_$f"; done。
