Java的SAXParseException怎么获取错误行号和列号

在Java的XML解析场景中，SAX解析方式因为内存占用低、解析速度快被广泛使用，当XML文件格式不符合规范时，解析过程会抛出SAXParseException异常，这个异常自带获取错误位置的方法，不需要开发者额外做复杂的逻辑处理。

SAXParseException的核心方法说明

SAXParseException是org.xml.sax包下的异常类，继承自SAXException，它提供了两个直接获取错误位置的方法：

• getLineNumber()：返回XML文件中发生错误的行号，行号从1开始计数。
• getColumnNumber()：返回XML文件中发生错误的列号，列号从1开始计数。

除此之外，还可以通过getPublicId()和getSystemId()获取对应的公共标识和系统标识，辅助定位错误资源。

完整获取示例

下面通过一个完整的示例演示如何捕获SAXParseException并获取错误行号和列号，首先准备一个存在格式错误的XML文件，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<user>
    <name>张三</name>
    <age>20</age
</user>

上面的XML中<age>标签的结束标签缺少右尖括号，解析时会触发异常。接下来是Java解析代码：

import org.xml.sax.SAXException;
import org.xml.sax.SAXParseException;
import org.xml.sax.helpers.DefaultHandler;
import javax.xml.parsers.SAXParser;
import javax.xml.parsers.SAXParserFactory;
import java.io.File;
import java.io.IOException;

public class SAXErrorDemo {
    public static void main(String[] args) {
        // 创建SAX解析器工厂
        SAXParserFactory factory = SAXParserFactory.newInstance();
        try {
            // 获取SAX解析器
            SAXParser parser = factory.newSAXParser();
            // 创建自定义处理器
            DefaultHandler handler = new DefaultHandler() {
                @Override
                public void error(SAXParseException e) throws SAXException {
                    // 捕获解析错误，输出行号和列号
                    System.out.println("解析错误发生位置：");
                    System.out.println("行号：" + e.getLineNumber());
                    System.out.println("列号：" + e.getColumnNumber());
                    System.out.println("错误信息：" + e.getMessage());
                }
            };
            // 解析XML文件，这里替换为你的XML文件路径
            parser.parse(new File("test.xml"), handler);
        } catch (SAXParseException e) {
            // 捕获SAXParseException异常
            System.out.println("捕获到SAXParseException异常：");
            System.out.println("错误行号：" + e.getLineNumber());
            System.out.println("错误列号：" + e.getColumnNumber());
            System.out.println("错误描述：" + e.getMessage());
        } catch (ParserConfigurationException | IOException e) {
            e.printStackTrace();
        }
    }
}

运行上面的代码，控制台会输出对应的错误行号和列号，根据输出信息可以快速定位到XML文件中第5行第10列附近的问题，也就是<age>标签的结束位置缺少右尖括号。

注意事项

• 如果XML解析器没有开启行号记录功能，getLineNumber()和getColumnNumber()可能返回-1，大部分默认的SAX解析器默认开启该功能，不需要额外配置。
• 行号和列号的计数从1开始，和很多文本编辑器的行号列号计数规则一致，方便直接对应到文件位置。
• 如果错误发生在XML声明部分，行号可能返回1，列号对应声明内容的位置。
• 除了error方法，fatalError方法也会抛出SAXParseException，同样可以通过这两个方法获取错误位置。

需要注意的是，如果XML文件是压缩或者经过特殊处理的，行号和列号可能和实际编辑时的位置有偏差，此时可以结合错误信息中的具体内容辅助定位。

SAXParseExceptionJavaXML解析错误行号错误列号修改时间：2026-07-06 04:12:19