XML文件中文字符读取解析乱码/异常问题求助

It sounds like you're running into classic encoding mismatches and invalid character problems when handling XML with Chinese text. Let's break down the most common fixes step by step:

1. First, Verify the Actual Encoding of Your Source XML File #

This is the #1 culprit for garbled text or parsing failures. Even if you specify UTF-8 in your code, if the file itself is saved in a different encoding (like GBK, GB2312, or Windows-1252), things will go wrong.

• Use a text editor like Notepad++ to check: Go to the Encoding menu to see what the file is actually saved as.
• If it's not UTF-8, you need to parse it using that specific encoding (e.g., Charset.forName("GBK")) instead of forcing UTF-8.

2. Fix How You Read the XML (Avoid Default Encoding) #

Java's FileReader uses your system's default encoding, which is often not UTF-8. Replace it with InputStreamReader to explicitly set the charset:

For DOM Parsing: #

FileInputStream fis = new FileInputStream("input.xml");
// Use the actual encoding of your file here (e.g., UTF-8 or GBK)
InputStreamReader isr = new InputStreamReader(fis, StandardCharsets.UTF_8);
DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
DocumentBuilder db = dbf.newDocumentBuilder();
Document doc = db.parse(new InputSource(isr));

For SAX Parsing: #

SAXParserFactory spf = SAXParserFactory.newInstance();
SAXParser sp = spf.newSAXParser();
InputSource is = new InputSource(new FileInputStream("input.xml"));
// Match this to your file's actual encoding
is.setEncoding("UTF-8");
sp.parse(is, yourSAXHandler);

3. Ensure Proper Encoding When Writing the XML Back #

When saving the parsed document, don't rely on default writers—explicitly set the output encoding and use OutputStreamWriter:

TransformerFactory tf = TransformerFactory.newInstance();
Transformer transformer = tf.newTransformer();
// Set output encoding to UTF-8 (or your desired encoding)
transformer.setOutputProperty(OutputKeys.ENCODING, "UTF-8");
transformer.setOutputProperty(OutputKeys.INDENT, "yes"); // Optional: for pretty printing

DOMSource source = new DOMSource(doc);
// Use OutputStreamWriter with explicit charset to avoid platform defaults
StreamResult result = new StreamResult(new OutputStreamWriter(
    new FileOutputStream("output.xml"), StandardCharsets.UTF_8
));
transformer.transform(source, result);

4. Fix Mismatched XML Declaration #

Check if your XML starts with a declaration like <?xml version="1.0" encoding="UTF-8"?>. If the file's actual encoding doesn't match this value, parsers will get confused.

• If the file is saved as GBK, update the declaration to encoding="GBK" (and parse with that charset).
• If there's no declaration, some parsers assume UTF-8, which will fail if the file uses a different encoding.

5. Clean Invalid XML Characters #

Sometimes XML contains illegal characters (like ASCII control characters 0x00-0x08) that break parsing. Filter these out before reading:

// Helper method to strip invalid XML characters
public static InputStream cleanInvalidXmlChars(InputStream input) throws IOException {
    BufferedReader reader = new BufferedReader(new InputStreamReader(input, StandardCharsets.UTF_8));
    StringBuilder sb = new StringBuilder();
    String line;
    while ((line = reader.readLine()) != null) {
        // Remove control characters that aren't allowed in XML
        sb.append(line.replaceAll("[\\x00-\\x08\\x0B\\x0C\\x0E-\\x1F]", "") + "\n");
    }
    return new ByteArrayInputStream(sb.toString().getBytes(StandardCharsets.UTF_8));
}

Use this cleaned stream when creating your InputSource for parsing.

6. Handle UTF-8 BOM (Byte Order Mark) #

If your XML file starts with a UTF-8 BOM (bytes 0xEFBBBF), some Java parsers treat it as part of the content, causing errors. Skip it manually:

FileInputStream fis = new FileInputStream("input.xml");
// Check for BOM and skip if present
int firstByte = fis.read();
if (firstByte != 0xEF || fis.read() != 0xBB || fis.read() != 0xBF) {
    fis.reset(); // Not a BOM, go back to the start of the file
}
InputStreamReader isr = new InputStreamReader(fis, StandardCharsets.UTF_8);

Quick Debugging Checklist #

1. Confirm the source XML's actual encoding with Notepad++.
2. Match your parsing/writing code's charset to the file's encoding.
3. Replace FileReader/FileWriter with InputStreamReader/OutputStreamWriter + explicit charsets.
4. Ensure the XML declaration's encoding matches the file's encoding.
5. Strip invalid control characters from the input.
6. Handle UTF-8 BOM if present.

Give these steps a try—most encoding issues with Chinese text in XML boil down to one of these fixes.

内容的提问来源于stack exchange，提问作者Sree