xlsx文件下载异常问题

前端调用我的后端接口下载xlsx文件，里面的数据没有正常展示。如下所示：

查看前端响应头里面。多了个charset=utf-8;

java 复制代码

application/octet-stream;charset=utf-8

如果是下面这种响应不会有问题，但是上面二进制流有charset=utf-8，浏览器会把这个当文本处理，不会解析成文件。

改动之前下载接口如下：

java 复制代码

  @ApiOperation(value = "oss文件下载")
    @GetMapping("downOssFile")
    public ResponseEntity<byte[]> getFileByUrl(String url, String fileName) {
        byte[] body = ossManager.download(url);
        HttpHeaders headers = new HttpHeaders();

        headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);
        try {
            String encodeFileName = URLEncoder.encode(fileName, "utf-8").replaceAll("\\+", "%20");
            headers.set("Content-Disposition", "attachment;filename=" + encodeFileName);
        } catch (UnsupportedEncodingException e) {
            log.error("oss文件下载失败，e:", e);
            throw new RuntimeException(e);
        }
        ResponseEntity<byte[]> result = ResponseEntity.ok().headers(headers).body(body);
        return result;
    }

这个接口返回体是使用Spring的ResponseEntity<byte[]> ， Spring 的 ByteArrayHttpMessageConverter 会序列化处理该响应体。最后过滤器在 response 提交后仍可修改 header。

检查我的web.xml文件配置是这样的，强制在所有接口的请求的响应头里面加上charset=UTF-8设置。这是问题的根源所在。

java 复制代码

    <filter>
		<filter-name>ProjectEncoding</filter-name>
		<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
		<async-supported>true</async-supported>
		<init-param>
			<param-name>encoding</param-name>
			<param-value>UTF-8</param-value>
		</init-param>
		<init-param>
			<param-name>forceEncoding</param-name>
			<param-value>true</param-value>
		</init-param>
	</filter>
	<filter-mapping>
		<filter-name>ProjectEncoding</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>

下面是我修改之后的下载接口：

java 复制代码

@ApiOperation(value = "oss文件下载")
    @GetMapping("downOssFile")
    public void getFileByUrl(String url, String fileName, HttpServletResponse response) throws IOException {
        byte[] body = ossManager.download(url);
        response.setHeader("Content-Type", "application/octet-stream");
        String encodeFileName = URLEncoder.encode(fileName, "utf-8").replaceAll("\\+", "%20");
        response.setHeader("Content-Disposition", "attachment;filename=" + encodeFileName);
        response.getOutputStream().write(body);
    }

使用原生的Response方法，绕过过滤器，getOutputStream().write() 会提前提交 response，过滤器无法再改charset。这样xlsx文件才能正常解析。

这个问题确实也排查了好久，总结来说对于上传以及下载文件异常问题首先考虑的就是响应头或者请求头，一般问题都出在这两个。