从可运行JAR生成Excel文件异常：无报错但代码中断

这种在IDE里正常跑、打包成可运行JAR就直接“哑火”的情况，大概率是依赖缺失或资源加载异常，而且POI在某些资源加载失败的场景下不会抛出明显的RuntimeException，反而会静默终止初始化流程，导致你的代码直接跳过后续逻辑。下面是几个最可能的原因和排查方向：

1. 打包时遗漏了POI的关键依赖库 #

XSSF（处理.xlsx格式）需要的依赖远不止poi.jar，你得确保以下核心依赖都被正确处理：

• poi-ooxml-*.jar：XSSF的核心实现类库
• poi-ooxml-schemas-*.jar：Excel OOXML格式的Schema定义文件
• xmlbeans-*.jar：处理XML Schema的基础依赖
• commons-compress-*.jar：POI用来处理压缩包的工具库
• curvesapi-*.jar（POI新版本需要）：辅助处理图形相关逻辑的依赖

如果用Eclipse导出可运行JAR，建议选择**“复制所需的库到生成的JAR所在的文件夹中”**，别选“提取到JAR中”——后者容易导致多个JAR里的同名资源（比如POI的schema文件）被覆盖，进而触发初始化失败。

2. POI内部资源文件未被正确加载 #

XSSFWorkbook初始化时需要加载内置的XML Schema文件（比如ooxml-schemas-*.jar里的*.xsd文件），当这些资源在JAR中无法被类加载器访问时，POI可能不会抛出异常，直接终止初始化。

你可以在创建XSSFWorkbook前加一段调试代码，验证资源是否能被加载：

ClassLoader classLoader = Thread.currentThread().getContextClassLoader();
System.out.println("能否加载核心schema文件: " + classLoader.getResource("org/openxmlformats/schemas/spreadsheetml/x2006/main/workbook.xsd"));

如果输出是null，就说明资源加载失败，问题出在打包时没把这些资源包含进去。

3. 类加载器冲突或运行权限问题 #

可运行JAR的类加载器和IDE里的行为有差异，如果你的JAR里混了多个版本的POI依赖，或者和其他第三方库的类加载逻辑冲突，可能会导致初始化失败。另外，如果JAR运行时系统权限不足（比如无法读取自身内部的资源文件），也可能出现这种静默失败的情况。

可以尝试在运行JAR时开启POI的调试日志，看内部执行细节：

java -jar your-app.jar -Dorg.apache.poi.util.POILogger=org.apache.poi.util.SystemOutLogger

这样POI的内部日志会输出到控制台，能帮你定位具体哪一步出了问题。

4. 检查是否有未捕获的异常 #

有时候不是没有抛出异常，而是你的代码没捕获到。比如这段逻辑在子线程执行，或者被宽泛的try-catch吞掉了异常，你可以把创建Workbook的代码包裹在捕获所有Throwable的块里：

try {
    XSSFWorkbook workbook = new XSSFWorkbook();
    System.out.println("Workbook创建成功！");
    // 后续业务代码
} catch (Throwable t) {
    t.printStackTrace();
}

这样哪怕是Error或者隐藏的RuntimeException，都会打印出完整的堆栈信息，帮你找到问题根源。

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