JXLS Transformer对象初始化失败问题求助

兄弟，我之前踩过JXLS 2.x里拿不到Transformer的坑，结合你描述的情况，大概率是这几个问题，给你捋捋解决方案：

你贴的依赖里只有jxls核心包，但JXLS 2.x处理Excel文件必须搭配对应的POI实现包jxls-poi，而且版本要和jxls完全一致（2.4.3）。很多人漏加这个依赖导致拿不到Transformer，先把依赖补全：

<dependency>
    <groupId>org.jxls</groupId>
    <artifactId>jxls</artifactId>
    <version>2.4.3</version>
</dependency>
<dependency>
    <groupId>org.jxls</groupId>
    <artifactId>jxls-poi</artifactId>
    <version>2.4.3</version>
</dependency>

如果你的项目用的是其他Excel引擎（比如jxls-jexcel），但绝大多数场景都是用jxls-poi，优先确认这个依赖是否正确引入。

JXLS 2.x和1.x的API差异很大，很多人沿用旧写法导致拿不到对象，给你两种正确的获取方式：

方式1：手动创建Transformer（适合自定义配置多的场景） #

如果需要手动控制细节，直接用PoiTransformer（对应POI引擎）创建实例，示例代码：

// 读取模板文件（Web场景可以用类加载器读resources下的模板）
InputStream templateInputStream = new FileInputStream("path/to/your-template.xlsx");
// 输出流如果是下载场景，用response的输出流即可
OutputStream outputStream = response.getOutputStream();

// 创建你需要的Transformer对象
Transformer transformer = PoiTransformer.createTransformer(templateInputStream, outputStream);

方式2：用JxlsHelper简化操作（推荐） #

JXLS提供了JxlsHelper工具类，能更简洁地获取Transformer并绑定自定义评估器，示例代码：

JxlsHelper jxlsHelper = JxlsHelper.getInstance();
// 读取模板流
InputStream templateStream = getClass().getResourceAsStream("/templates/your-template.xlsx");
// 下载场景的输出流
OutputStream outputStream = response.getOutputStream();

// 获取Transformer实例
Transformer transformer = jxlsHelper.createTransformer(templateStream, outputStream);
// 绑定你的自定义评估器
ExpressionEvaluator customEvaluator = new YourCustomExpressionEvaluator();
transformer.setExpressionEvaluator(customEvaluator);

// 填充数据并处理模板
Context context = new Context();
context.putVar("dataList", yourBusinessData);
jxlsHelper.processTemplate(context, transformer);

确保你的自定义评估器正确实现了ExpressionEvaluator接口，并且在填充数据之前绑定到Transformer上。比如评估器的示例：

public class YourCustomExpressionEvaluator implements ExpressionEvaluator {
    @Override
    public Object evaluate(String expression, Context context) {
        // 这里写你的自定义表达式解析逻辑
        // 比如处理自定义函数、特殊变量等
        return yourEvaluationResult;
    }

    // 别忘了实现接口里的其他方法，比如evaluateBoolean、evaluateDouble等
}

如果你的评估器需要依赖其他工具类，也要确保初始化时已经正确实例化，避免因评估器本身异常导致Transformer绑定失败。

• 如果报ClassNotFoundException：100%是依赖不全，检查jxls-poi是否引入，或者项目中是否有POI版本冲突（可以用mvn dependency:tree查看依赖树，排除冲突的POI版本）。
• 如果报NullPointerException：检查模板输入流是否为空，或者输出流是否正确打开（比如Web场景中response的输出流有没有被提前关闭）。
• 如果自定义评估器不生效：确认是否调用了transformer.setExpressionEvaluator(customEvaluator)，并且调用时机在processTemplate之前。

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