Java程序部署服务器，servlet-api导致接口下载文件失败/文件为空/文件名不对

小半 • 2023年2月7日下午5:39 • 技术随笔 • 阅读 355

1.问题：

昨天把项目打包放到国产中间件东方通（外部容器，功能类似Tomcat）上时，发现某些请求下载文件的接口不能正确返回文件，而是返回一个空的文件，名称是接口名最后一个词fj，

然而这个功能直接使用IDE启动时没问题的，打包放到Tomcat9上也没问题，那可能是东方通适配问题了

2.原代码：

部署在服务器上系统以后，在线打断点，发现跑到这一部分就在第三行位置执行不下去

    response.setContentType("application/force-download");
    response.setCharacterEncoding("utf-8");
    response.setContentLengthLong(fileMetaData.getSize());
    response.setHeader("Content-Disposition", "attachment;filename=" + encodeChineseDownloadFileName(request, qualifiedFileName));

3.错误原因：

servlet-api.jar 版本问题，系统使用了新版本的方法，东方通上旧版本jar没这个方法

4.解决

response是HttpServletResponse类型的，
看一下这个类在哪：javax\servlet\javax.servlet-api\4.0.1\javax.servlet-api-4.0.1.jar!\javax\servlet\http\HttpServletResponse.class

发现这个类是javax.servlet-api-4.0.1.jar包里的类

我在迁移系统到TongWeb上的时候，做了一些jar包改动，依稀记得看到过lib下使用的是servlet-api.jar

我把jar下下来，压缩文件打开，去寻找此类，发现这些文件都是2012年的，说明这版东方通使用的servlet-api版本老

使用IDEA打开class，在structure中查看，发现我们代码中用到的方法只有setHeader

再看一下集成的接口ServletResponse，发现只找到setContentType、setCharacterEncoding

看一下程序依赖的版本，好吧，新版本有这个方法

5.新代码：

去掉这一行，接口返回正确的文件

    response.setContentType("application/force-download");
    response.setCharacterEncoding("utf-8");
    //response.setContentLengthLong(fileMetaData.getSize());
    response.setHeader("Content-Disposition", "attachment;filename=" + encodeChineseDownloadFileName(request, qualifiedFileName));