EasyExcel多Sheet导出与动态水印实现技巧

1. EasyExcel多Sheet导出基础实现第一次用EasyExcel导出多Sheet报表时我踩了个典型的坑明明代码里创建了三个Sheet导出的文件却只显示最后一个。后来发现是没掌握Builder模式的正确用法。这里分享下标准的多Sheet导出模板// 创建ExcelWriter时不要指定sheet ExcelWriter excelWriter EasyExcel.write(outputStream) .registerWriteHandler(new CustomSheetWriteHandler()) .build(); // 每个sheet独立构建 WriteSheet sheet1 EasyExcel.writerSheet(0, 销售数据) .head(SalesData.class).build(); WriteSheet sheet2 EasyExcel.writerSheet(1, 用户统计) .head(UserStats.class).build(); // 分批次写入数据 excelWriter.write(salesDataList, sheet1); excelWriter.write(userStatsList, sheet2); excelWriter.finish();关键点在于ExcelWriter实例的复用。常见错误是每个Sheet都新建writer这会导致文件覆盖。实测在10万行数据场景下复用writer比单独创建效率提升40%左右。多Sheet处理还有个隐藏坑内存溢出风险。当单个Sheet超过50万行时建议启用SXSSF模式ExcelWriterBuilder builder EasyExcel.write(outputStream) .inMemory(false) // 启用磁盘缓存 .excelType(ExcelTypeEnum.XLSX);2. 动态水印的实现原理水印的本质是把图片设置为工作表背景。但直接设置背景图会遇到两个问题1) 图片无法自适应Sheet大小 2) 多Sheet时重复渲染。通过分析POI源码我找到了更优雅的解决方案。水印自适应核心算法// 根据文字内容计算图片尺寸考虑旋转角度 int width (int)(textWidth * Math.cos(radians)) padding; int height (int)(textWidth * Math.sin(radians)) padding; // 创建透明背景的BufferedImage BufferedImage image new BufferedImage(width, height, BufferedImage.TYPE_INT_ARGB);这里有个性能优化点提前缓存水印图片。实测显示相同水印文本在100个Sheet中重复生成图片耗时增加300ms。我的做法是在Watermark类初始化时就创建好图片对象。多Sheet水印的关键在于正确获取XSSFSheet实例。网上很多方案通过反射获取_sh字段这在EasyExcel 3.x版本会报错。正确做法是public void afterSheetCreate(WriteWorkbookHolder holder, WriteSheetHolder sheetHolder) { // 直接转型获取原生Sheet对象 XSSFSheet sheet (XSSFSheet) sheetHolder.getSheet(); setWatermark(sheet, cachedImage); }3. 多Sheet水印的常见问题解决3.1 文件损坏问题当导出5个以上Sheet时可能会遇到文件无法打开的情况。经过字节码分析发现是图片资源重复写入导致的。解决方案是在PackagePart添加时检查重复PackagePartName partName pictureData.getPackagePart().getPartName(); if(!sheet.getPackagePart().getRelationshipsByType(XSSFRelation.IMAGES.getRelation()) .contains(partName)) { sheet.getPackagePart().addRelationship(...); }3.2 水印位置偏移旋转角度大于45度时文字经常显示不全。这个问题源于Java2D的坐标系转换。修正后的绘制逻辑// 修正后的坐标计算 int x (int)(height * Math.sin(radians)) margin; int y (int)(width * Math.cos(radians)) margin; // 设置旋转锚点为图片中心 transform.rotate(radians, width/2, height/2);3.3 性能优化方案在导出10万行数据水印的场景下我总结出三个优化点使用SXSSFWorkbook替代XSSFWorkbook内存占用降低70%水印图片预生成并复用关闭自动列宽计算.autoCloseStream(false)实测数据显示优化后导出时间从8.2秒降至3.5秒。4. 高级应用动态水印策略实际项目中我们可能需要根据不同Sheet添加不同水印。比如财务报表需要机密水印而公开数据只要日期标记。这里分享我的策略模式实现public interface WatermarkStrategy { Watermark getWatermark(WriteSheetHolder holder); } // 在拦截器中动态获取 public void afterSheetCreate(...) { Watermark watermark strategy.getWatermark(sheetHolder); // 应用水印... }结合Spring时可以这样注册处理器Bean public CustomWaterMarkHandler auditWatermark() { return new CustomWaterMarkHandler( (holder) - new Watermark(审计版本- LocalDate.now()) ); }对于需要加密的场景建议在设置水印后锁定Sheetsheet.protectSheet(密码123); sheet.lockDeleteColumns(true); sheet.lockFormatCells(true);最近在金融项目中实践发现动态水印结合单元格权限控制可以构建出完善的文档安全体系。比如交易流水Sheet只允许查看而汇总Sheet允许修改特定单元格。