文档建议反馈控制台
首页
学习
活动
专区
圈层
工具
MCP广场
文章/答案/技术大牛
发布
社区首页 >专栏 >SpringBoot项目中使用poi-tl打成jar包后常见问题及解决

SpringBoot项目中使用poi-tl打成jar包后常见问题及解决

原创
作者头像
夜郎King
发布于 2026-05-11 23:24:19
发布于 2026-05-11 23:24:19
990
举报
文章被收录于专栏：JavaJava

​

前言

在前面的博客中，介绍了如何在Java中根据模板动态写入数据到word模板中，原文地址：Java使用poi-tl1.9.1生成Word文档的几个小技巧。这里给出的案例是直接生成到本地目录中，在实际项目开发过程中，一般会采用web请求的方式，动态的将数据设置到Word中，同时将文件下载到本地。

在基于SpringBoot的开发环境中，我们经常会将实际部署的包打包成jar包的形式进行部署。在以上的场景开发中，不知道您是否会遇到以下的问题。比如会遇到模板找不到报错，还有请求智能点击一次的问题产生。

本文将针对以上两种情况，分析并解决在SpringBoot环境中，将Poi-tl应用打包成jar后的实际运行问题进行解决。如果在平常开发过程中也遇到这种问题，可以试试博文的方案，看是否可以解决您的问题。

一、场景描述

1、打成jar包运行后模板找不到

代码语言：txt
复制
java.io.FileNotFoundException: class path resource [report/temp.docx] cannot be resolved to absolute file path because it does not reside in the file system: jar:file:/ROOT/xxx.jar!/BOOT-INF/lib/xxx-2.1.jar!/report/temp.docx 
    at org.springframework.util.ResourceUtils.getFile(ResourceUtils.java:217) 
    at org.springframework.core.io.AbstractFileResolvingResource.getFile(AbstractFileResolvingResource.java:154) 
　　 ...​

通常来说，如果遇到上述的这种异常错误信息，一般都是因为获取docx模板的代码不对导致的，知道了问题的关键就可以针对性进行解决。

解决方案

在springboot项目中，对于打成jar包后的项目，如果想正常访问resource目录下的文件，建议采用以下的代码进行修复。

代码语言：txt
复制
InputStream is = this.getClass().getClassLoader().getResourceAsStream("report/temp.docx");

在word模板写入的时候，可以采用以下的代码：

代码语言：txt
复制
template = XWPFTemplate.compile(is).render(map);

XWPFTemplate模板在写出的时候，可以支持直接对一个输入流进行内容写入。

2、文件只能下载一次

在使用poi-tl生成word的时候，可能会遇到第一次请求下载文件是正常的，但是在第二次需要下载时浏览器则失去响应，就像假死一样。可能前端的小伙伴还会把锅刷到浏览器头上。这里需要注意的是，在进行IO读写的时候，千万要记得关流。

如果你也遇到这种失去响应的情况，通常是因为忘记关流了。这里分享一段错误的代码示范：

代码语言：txt
复制
private String createReport() throws Exception{
		String reportDir = RuoYiConfig.getProfile() + "/report";
		InputStream is = null;
		XWPFTemplate template = null;
		FileOutputStream out = null;
		try {
			is = this.getClass().getClassLoader().getResourceAsStream("report/temp.docx");
			Map<String, Object> map = new HashMap<String,Object>();
	        map.put("score", "28");
	        map.put("title", "测试任务");
	        map.put("type", "上半年综合测评");
	        map.put("status", "已完成");
	        map.put("time", "2023-07-18");
	        map.put("locpicture", new PictureRenderData(400, 300, "D:/image.jpg"));
	        map.put("urlImg", Pictures.ofUrl("https://p1.itc.cn/images01/20230418/5d13ab4a86c04a8dac668bf4129e1f0c.png", PictureType.PNG).size(400, 300).create());
	        ChartMultiSeriesRenderData sbqk = Charts
	                .ofMultiSeries("十六市区县情况", new String[] { "济南","青岛","烟台","威海"})
	                .addSeries("上报情况", new Double[] { 15.0,20.6,42.6,90.1})
	                .addSeries("查出情况", new Double[] { 12.0,15.3,28.6,80.1})
	                .create();
	        map.put("sbqk", sbqk);
	 
	        ChartMultiSeriesRenderData sjzlpm = Charts
	                .ofMultiSeries("医院综合排名", new String[] { "山东大学齐鲁医院","山东省泰山医院","山东省第二人民医院","山东省第三医院"})
	                .addSeries("数据质量排名", new Double[] { 70.5,40.6,22.7,85.4})
	                .addSeries("价格质量排名", new Double[] { 80.5,75.6,72.7,85.4})
	                .create();
	 
	        map.put("sjzlpm", sjzlpm);
	        ChartMultiSeriesRenderData qst = Charts
	                .ofMultiSeries("任务趋势", new String[] { "06-10","06-11","06-12","06-13","06-14","06-15"})
	                .addSeries("微信端", new Double[] { 70.5,40.6,22.7,85.4,700.0,40.8})
	                .addSeries("PC端", new Double[] { 80.5,50.6,62.7,45.4,200.0,140.8})
	                .addSeries("小程序端", new Double[] { 120.5,520.6,362.7,405.4,300.0,340.8})
	                .create();
	        map.put("qst", qst);
	        //柱状图、折线图共存
	        List<SeriesRenderData> seriesRenderData = new ArrayList<SeriesRenderData>(3);
	        SeriesRenderData series1 = new SeriesRenderData("GDP", new Double[] {70.5,40.6,22.7,85.4,700.0,40.8});
	        series1.setComboType(SeriesRenderData.ComboType.BAR);
	        seriesRenderData.add(series1);
	        SeriesRenderData series2 = new SeriesRenderData("人口", new Double[] {80.5,50.6,62.7,45.4,200.0,140.8});
	        series2.setComboType(SeriesRenderData.ComboType.BAR);
	        seriesRenderData.add(series2);
	        SeriesRenderData series3 = new SeriesRenderData("指数", new Double[] {0.6,0.6,0.7,0.4,0.7,0.8});
	        series3.setComboType(SeriesRenderData.ComboType.LINE);
	        seriesRenderData.add(series3);
	        ChartMultiSeriesRenderData hntb = Charts
	                .ofMultiSeries("某省社会排名", new String[] { "城市1","城市2","城市3","城市4","城市5","城市6"})
	                .create();
	        hntb.setSeriesDatas(seriesRenderData);
	        
	        map.put("hntb", hntb);
	        template = XWPFTemplate.compile(is).render(map);
	        File reportDirFile = new File(reportDir);
	        if(!reportDirFile.exists()) {
	        	reportDirFile.mkdir();
	        }
	        out = new FileOutputStream(new File(reportDir + "/生成报告结果.docx"));
	        template.write(out);
	        out.flush();
		} catch (Exception e) {
		}finally {
			if(null != out)out.close();
			if(null != template) template.close();
			//if(null != is)is.close();
		}
		return reportDir + "/生成报告结果.docx";
	}

这里将is的流关闭一行注释掉，模拟流未关闭的情况。此时在浏览器中进行文件下载，大概率会得到一个无法下载的错误。

二、正确示范

为了方式大家在复制的过程中遇到错误的示范问题，这里给出一段参考代码，其中已经将核心敏感的数据进行处理掉，但具体的业务逻辑不变，供参考，模板信息如下。

1、Controller下载方法定义

在基于Ruoyi的SpringBoot项目开发中，需要定义一个用于接收前台请求的下载对象及处理方法，参考代码如下：

代码语言：txt
复制
package com.ruoyi.project.demo.controller;

import java.io.File;
import java.io.FileOutputStream;
import java.io.InputStream;
import java.io.UnsupportedEncodingException;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

import javax.servlet.http.HttpServletResponse;

import org.springframework.http.MediaType;
import org.springframework.stereotype.Controller;
import org.springframework.util.ResourceUtils;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;

import com.deepoove.poi.XWPFTemplate;
import com.deepoove.poi.data.ChartMultiSeriesRenderData;
import com.deepoove.poi.data.Charts;
import com.deepoove.poi.data.PictureRenderData;
import com.deepoove.poi.data.PictureType;
import com.deepoove.poi.data.Pictures;
import com.deepoove.poi.data.SeriesRenderData;
import com.ruoyi.common.utils.file.FileUtils;
import com.ruoyi.framework.config.RuoYiConfig;
import com.ruoyi.framework.web.controller.BaseController;

@Controller
@RequestMapping("/demo/wordownload")
public class WordDownLoadController extends BaseController{

	@GetMapping("/test")
    public void test(HttpServletResponse response) throws Exception {
        String realFileName = "生成报告结果.docx";
        String filePath = this.createReport();
        response.setContentType(MediaType.APPLICATION_OCTET_STREAM_VALUE);
        FileUtils.setAttachmentResponseHeader(response, realFileName);
        FileUtils.writeBytes(filePath, response.getOutputStream());
    }
}

2、文档生成

代码语言：txt
复制
private String createReport() throws Exception{
		String reportDir = RuoYiConfig.getProfile() + "/report";
		InputStream is = null;
		XWPFTemplate template = null;
		FileOutputStream out = null;
		try {
			is = this.getClass().getClassLoader().getResourceAsStream("report/temp.docx");
			Map<String, Object> map = new HashMap<String,Object>();
	        map.put("score", "28");
	        map.put("title", "测试任务");
	        map.put("type", "上半年综合测评");
	        map.put("status", "已完成");
	        map.put("time", "2023-07-18");
	        map.put("locpicture", new PictureRenderData(400, 300, "D:/image.jpg"));
	        map.put("urlImg", Pictures.ofUrl("https://p1.itc.cn/images01/20230418/5d13ab4a86c04a8dac668bf4129e1f0c.png", PictureType.PNG).size(400, 300).create());
	        ChartMultiSeriesRenderData sbqk = Charts
	                .ofMultiSeries("十六市区县情况", new String[] { "济南","青岛","烟台","威海"})
	                .addSeries("上报情况", new Double[] { 15.0,20.6,42.6,90.1})
	                .addSeries("查出情况", new Double[] { 12.0,15.3,28.6,80.1})
	                .create();
	        map.put("sbqk", sbqk);
	 
	        ChartMultiSeriesRenderData sjzlpm = Charts
	                .ofMultiSeries("医院综合排名", new String[] { "山东大学齐鲁医院","山东省泰山医院","山东省第二人民医院","山东省第三医院"})
	                .addSeries("数据质量排名", new Double[] { 70.5,40.6,22.7,85.4})
	                .addSeries("价格质量排名", new Double[] { 80.5,75.6,72.7,85.4})
	                .create();
	 
	        map.put("sjzlpm", sjzlpm);
	        ChartMultiSeriesRenderData qst = Charts
	                .ofMultiSeries("任务趋势", new String[] { "06-10","06-11","06-12","06-13","06-14","06-15"})
	                .addSeries("微信端", new Double[] { 70.5,40.6,22.7,85.4,700.0,40.8})
	                .addSeries("PC端", new Double[] { 80.5,50.6,62.7,45.4,200.0,140.8})
	                .addSeries("小程序端", new Double[] { 120.5,520.6,362.7,405.4,300.0,340.8})
	                .create();
	        map.put("qst", qst);
	        //柱状图、折线图共存
	        List<SeriesRenderData> seriesRenderData = new ArrayList<SeriesRenderData>(3);
	        SeriesRenderData series1 = new SeriesRenderData("GDP", new Double[] {70.5,40.6,22.7,85.4,700.0,40.8});
	        series1.setComboType(SeriesRenderData.ComboType.BAR);
	        seriesRenderData.add(series1);
	        SeriesRenderData series2 = new SeriesRenderData("人口", new Double[] {80.5,50.6,62.7,45.4,200.0,140.8});
	        series2.setComboType(SeriesRenderData.ComboType.BAR);
	        seriesRenderData.add(series2);
	        SeriesRenderData series3 = new SeriesRenderData("指数", new Double[] {0.6,0.6,0.7,0.4,0.7,0.8});
	        series3.setComboType(SeriesRenderData.ComboType.LINE);
	        seriesRenderData.add(series3);
	        ChartMultiSeriesRenderData hntb = Charts
	                .ofMultiSeries("某省社会排名", new String[] { "城市1","城市2","城市3","城市4","城市5","城市6"})
	                .create();
	        hntb.setSeriesDatas(seriesRenderData);
	        
	        map.put("hntb", hntb);
	        template = XWPFTemplate.compile(is).render(map);
	        File reportDirFile = new File(reportDir);
	        if(!reportDirFile.exists()) {
	        	reportDirFile.mkdir();
	        }
	        out = new FileOutputStream(new File(reportDir + "/生成报告结果.docx"));
	        template.write(out);
	        out.flush();
		} catch (Exception e) {
		}finally {
			if(null != out)out.close();
			if(null != template) template.close();
			if(null != is)is.close();
		}
		return reportDir + "/生成报告结果.docx";
	}

总结

以上就是本文的主要内容，文章主要讲解了在SpringBoot中使用Poi-tl进行模板生成时，容易遇到的两个异常场景，以及针对性的给出了相应的解决方案。以上代码经过实际代码运行测试，可以正常使用。行文仓促，如有不当，尽请批评指正。

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

poi
jar
spring boot

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

poi
jar
spring boot
#poi-tl
#word处理
评论
登录后参与评论
0 条评论
热度
最新
登录 后参与评论
推荐阅读
目录
  • 前言
  • 一、场景描述
    • 1、打成jar包运行后模板找不到
    • 2、文件只能下载一次
  • 二、正确示范
    • 1、Controller下载方法定义
    • 2、文档生成
  • 总结
领券

腾讯云开发者

扫码关注腾讯云开发者

扫码关注腾讯云开发者

领取腾讯云代金券

热门产品

热门推荐

更多推荐

Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有 

深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 粤公网安备44030502008569号

腾讯云计算（北京）有限责任公司 京ICP证150476号 |  京ICP备11018762号

问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档

Copyright © 2013 - 2026 Tencent Cloud.

All Rights Reserved. 腾讯云 版权所有

登录 后参与评论