添加重复校验后Apache POI无法写入.xls文件且无异常抛出

这种情况我之前做类似功能时也踩过坑，大概率是校验逻辑里的文件流处理、判断条件或者POI的工作簿状态出了问题，没抛出异常往往是因为异常被静默吞掉，或者POI的某些操作本身不会触发显性异常。给你梳理几个核心排查方向：

1. 先查文件流的打开/关闭逻辑 #

加了重复校验后，很多人会先打开Excel读数据，读完却没正确关闭流，导致后续写入时文件被占用，但POI有时候不会抛出明确的IOException，只会静默失败。比如这种错误写法：

// 错误示例：读完工作簿没关闭，文件被锁定
Workbook readWorkbook = new XSSFWorkbook(new FileInputStream("users.xlsx"));
// 执行重复校验逻辑...
// 直接打开输出流写入，此时读流还没释放
FileOutputStream fos = new FileOutputStream("users.xlsx");
readWorkbook.write(fos);

解决办法：校验完成后，必须先关闭读模式的Workbook和对应的输入流，再重新打开写入模式的工作簿实例。

2. 检查重复校验的判断逻辑是否写反 #

很容易犯的低级错误：本来应该是「用户不存在才写入」，结果写成了「用户存在才写入」，或者字段匹配错误（比如只校验了用户名，却忽略了邮箱/手机号等唯一标识，导致误判重复）。建议在校验后加个日志打印，确认逻辑是否符合预期：

boolean isDuplicate = checkUserExists(workbook, newUserInfo);
System.out.println("当前用户是否重复：" + isDuplicate); // 先确认这个值是否正确
if (!isDuplicate) {
    writeUserToExcel(newUserInfo);
}

3. 避免用同一个Workbook实例做读和写 #

如果你的校验和写入复用了同一个Workbook对象，可能会因为读取操作改变了工作簿的内部状态，导致后续写入失败。最好把校验和写入拆成两个独立的流程：

// 第一步：单独做重复校验
boolean exists = checkDuplicate("users.xlsx", newUser);
// 第二步：校验不通过才执行写入
if (!exists) {
    writeNewUserToExcel("users.xlsx", newUser);
}

分开处理能避免同一个工作簿实例的状态冲突。

4. 检查是否有异常被静默捕获 #

你说「无任何异常抛出」，很大概率是代码里的try-catch块吞了异常。比如这种写法：

try {
    // 校验或写入逻辑
} catch (Exception e) {
    // 这里什么都没做，异常直接被吞了！
}

一定要在catch块里打印异常信息，比如e.printStackTrace()或者用日志框架记录，这样才能知道到底哪里出了问题。

5. 排查文件权限问题 #

如果程序运行的用户没有目标Excel文件的写入权限，POI可能不会抛出明显异常，只会写入失败。可以尝试把文件路径换成桌面这类权限明确的位置测试，或者检查文件的读写权限设置。

先从这几个方向排查，尤其是文件流和逻辑判断这两点，大概率能找到问题。如果还是解决不了，可以把你的校验和写入核心代码片段贴出来，能更精准定位。

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