Java中导入 Excel 数据校验失败怎么抛出包含行号列号的 ImportValidationException-java教程-PHP中文网

核心是封装行列定位信息到自定义异常：继承runtimeexception，含sheetname、rownum、columnnum、message字段，提供带参构造方法并重写getmessage()返回[sheet:xxx, row:x, col:x]格式提示；easyexcel在invoke()中用context.readrowholder().getrowindex()获取行号，poi则用row.getrownum()+1和cell.getcolumnindex()+1计算真实行列号，校验失败即抛出该异常，再由@controlleradvice统一响应结构化错误信息。

java中导入 excel 数据校验失败怎么抛出包含行号列号的 importvalidationexception

在 Java 中使用 Apache POI 或 EasyExcel 导入 Excel 时，若校验失败需抛出自定义异常并携带具体行列信息，核心是：在读取每行数据过程中主动捕获校验逻辑错误，并将当前 sheetIndex、rowIndex、cellIndex（注意：Excel 行列号通常从 1 开始，而 POI 索引从 0 开始，需 +1）封装进异常。

定义 ImportValidationException（含行列定位信息）

自定义异常应包含可读性强的定位字段，方便前端或日志快速定位问题单元格：

继承 RuntimeException（避免强制 try-catch），添加 sheetName、rowNum、columnNum、message 字段
提供带行列号的构造方法，例如：new ImportValidationException("手机号格式错误", "用户表", 5, 3) 表示第 5 行第 3 列
重写 toString() 或 getMessage()，返回类似 [Sheet:用户表, Row:5, Col:3] 手机号格式错误

在 Excel 解析回调中触发校验并抛出异常

以 EasyExcel 为例，在 AnalysisEventListener 的 invoke() 方法中处理每一行数据时做校验：

Java Linux版

Java Linux版下载入口，提供 Oracle JDK 26.0.2 官方 Linux 安装包、Java 环境配置、JDBC 数据库连接和 Java 服务端开发相关信息。

下载

通过 context.readRowHolder().getRowIndex() 获取当前行号（EasyExcel 默认从 1 开始）
列号需结合表头映射或 HeadMeta 推断；若用 @ExcelProperty(index = 2)，则列号为 index + 1
校验失败时直接 new 异常并 throw，EasyExcel 会中断后续解析并抛出该异常
示例：if (!PhoneUtil.isValid(phone)) { throw new ImportValidationException("手机号非法", sheetName, rowNum, 3); }

使用 Apache POI 时手动维护行列索引

POI 需显式跟踪行列位置，尤其注意空行跳过但行号仍需连续计数：

外层遍历 Sheet 时记录 sheetIndex 和 sheet.getSheetName()
遍历 Row 时用 row.getRowNum() + 1 得到真实行号（POI 索引从 0）
遍历 Cell 时用 cell.getColumnIndex() + 1 得到真实列号
对每个非空单元格做校验，失败即 throw，同时建议 catch 后包装再抛，确保异常不被吞掉

全局异常处理器统一响应（可选但推荐）

Spring Boot 项目中可用 @ControllerAdvice 捕获 ImportValidationException 并转为标准错误响应：

提取异常中的 sheetName、rowNum、columnNum、message，组装成 JSON 返回给前端
响应体示例：{"code":400,"msg":"导入校验失败","data":{"sheet":"用户表","row":5,"col":3,"reason":"邮箱格式不合法"}}
避免把原始异常堆栈暴露给前端，提升用户体验和安全性