JasperReportsViewResolver与Spring MVC：导出文件名设置问题求助

嘿，我之前也碰到过一模一样的问题！其实要给导出的PDF/Excel设置自定义文件名，有几种实用的方法，结合你的Spring MVC配置来调整就行：

1. 给具体的报表视图Bean直接配置文件名 #

如果你是用JasperReportsPdfView或者JasperReportsXlsxView这类针对性的视图Bean，可以直接添加contentDisposition属性来指定文件名，还能控制是浏览器打开还是下载：

<!-- PDF报表视图示例 -->
<bean id="salesPdfReport" class="org.springframework.web.servlet.view.jasperreports.JasperReportsPdfView">
    <property name="url" value="classpath:/jasper/sales-report.jasper"/>
    <property name="reportDataKey" value="dataSource"/>
    <!-- attachment表示触发下载，inline表示在浏览器内打开 -->
    <property name="contentDisposition" value="attachment;filename=2024年度销售报表.pdf"/>
</bean>

<!-- Excel报表视图示例 -->
<bean id="salesExcelReport" class="org.springframework.web.servlet.view.jasperreports.JasperReportsXlsxView">
    <property name="url" value="classpath:/jasper/sales-report.jasper"/>
    <property name="reportDataKey" value="dataSource"/>
    <property name="contentDisposition" value="attachment;filename=2024年度销售报表.xlsx"/>
</bean>

2. 通过JasperReportsViewResolver实现动态文件名 #

你已经配置了JasperReportsViewResolver，可以给它设置动态的文件名规则，这样不同报表能自定义名称：
首先完善你的resolver配置，用模型变量来占位文件名：

<bean id="jasperViewResolver" class="org.springframework.web.servlet.view.jasperreports.JasperReportsViewResolver">
    <property name="prefix" value="classpath:/jasper/"/>
    <property name="reportDataKey" value="dataSource"/>
    <property name="suffix" value=".jasper"/>
    <!-- 用模型中的reportFileName变量动态生成文件名 -->
    <property name="contentDisposition" value="attachment;filename=${reportFileName}"/>
</bean>

然后在Controller里，把想要的文件名放到模型中：

@RequestMapping("/exportSalesReport")
public ModelAndView exportSalesReport(ModelAndView mv) {
    // 填充报表数据源
    mv.addObject("dataSource", getSalesDataSource());
    // 设置带后缀的文件名
    mv.addObject("reportFileName", "2024年Q3销售报表.pdf");
    // 指定对应的jasper报表文件（对应classpath:/jasper/sales-report.jasper）
    mv.setViewName("sales-report");
    return mv;
}

3. 手动操作HttpServletResponse（最灵活的方案） #

如果上面的配置方式满足不了需求，还可以直接在Controller里操作响应头来控制文件名，这种方式自由度最高：

@RequestMapping("/exportCustomPdf")
public void exportCustomPdf(HttpServletResponse response) throws Exception {
    // 加载jasper报表文件
    InputStream reportStream = getClass().getResourceAsStream("/jasper/custom-report.jasper");
    JasperReport jasperReport = (JasperReport) JRLoader.loadObject(reportStream);
    
    // 填充报表数据
    Map<String, Object> params = new HashMap<>();
    JasperPrint jasperPrint = JasperFillManager.fillReport(jasperReport, params, getCustomDataSource());
    
    // 设置响应头，指定文件名和类型
    response.setContentType("application/pdf");
    // 中文文件名记得编码，避免乱码
    String encodedFileName = URLEncoder.encode("自定义报表名称.pdf", "UTF-8");
    response.setHeader("Content-Disposition", "attachment;filename=" + encodedFileName);
    
    // 把报表输出到响应流
    JasperExportManager.exportReportToPdfStream(jasperPrint, response.getOutputStream());
}

要是导出Excel，只需要把ContentType改成application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，文件名后缀换成.xlsx，输出方法换成JasperExportManager.exportReportToXlsxStream即可。

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