必须先用file、chardet或PowerShell等工具确认XML文件真实编码，不可轻信声明或编辑器显示；读取时应绕过XML声明，显式指定真实编码解析；写入时需同步更新声明与字节流；HTTP传输中Content-Type优先级高于XML声明，须防止网关错误注入charset。
先确认真实编码，别信声明或编辑器显示
XML声明里的encoding="UTF-8"只是“说法”，不等于文件真是UTF-8。很多老系统导出的XML写着UTF-8，实际是GBK；记事本另存时勾选了UTF-8但没清BOM，也会导致解析失败。用命令行工具查真实字节：
-
file -i your.xml（Linux/macOS）看charset=后面是什么 -
chardet your.xml（需pip install chardet）输出概率最高的编码，比如utf-8 (0.97) - Windows可用PowerShell：
Get-Content your.xml -Encoding Byte | Select-Object -First 4，检查开头是否为EF BB BF（UTF-8 BOM）
读取时绕过声明，强制指定编码
Java默认解析器会盲从XML声明，一旦不匹配就抛SAXParseException或静默乱码。安全做法是跳过声明，自己控制解码：
- 用
InputStream读原始字节，再套InputStreamReader指定编码 - 构造
InputSource并显式设setEncoding("GBK")或"UTF-8" - 示例代码：
InputStream is = new FileInputStream("data.xml");<br>InputSource source = new InputSource(is);<br>source.setEncoding("GBK"); // 与真实编码一致<br>Document doc = builder.parse(source);
写入时确保声明和字节流同步
生成XML时，只设OutputKeys.ENCODING不够——它只改声明，不改底层字节流：
立即学习“Java免费学习笔记（深入）”；
- 必须用
OutputStreamWriter包装FileOutputStream，并传StandardCharsets.UTF_8 - 再把
OutputStreamWriter交给Transformer输出 - 否则会出现“声明UTF-8，内容却是平台默认编码（如GBK）”的错配
上传或网络传输场景要额外防代理干扰
HTTP响应头中的Content-Type: text/xml; charset=UTF-8优先级高于XML声明。如果Nginx或网关层强行注入这个头，但返回的XML字节仍是GBK，客户端就会按UTF-8硬解，中文全变方块：
- 用
curl -v抓包，查看响应头和原始响应体十六进制 - 比对中文部分的字节序列：UTF-8中文是3字节（如
E4.B8.AD），GBK是2字节（如D6 D0） - 网关配置中避免使用
charset utf-8全局重写，让后端自己控制编码
