123 safari 浏览器中下载 URLEncoder.encode 的中文名称的文件, safari 未进行解码, 其他浏览器正常

前言

这是最近碰到的一个关于文件下载的一个问题

然后只有 safari 中出现了此问题, 大概可能是不同的浏览器对于 http 协议的细节支持有所差异吧

大概就是有一个服务提供了文件下载的功能, 然后次服务使用的是 URLEncoder.encode 进行编码了, 然后大多数主流浏览器下载都是正常下载中文名

但是 safari 中下载, 下载的文件名还是 URLEncoder.encode 编码之后的结果的文件名然后造成的问题

测试用例

该测试服务如下, 这里模拟一下

复制代码

    /**
     * downloadTxt
     *
     * @param response  response
     * @return void
     * @author Jerry.X.He
     * @date 2024-09-21 10:56
     */
    @GetMapping("/downloadTxt")
    public void downloadTxt(HttpServletResponse response) throws Exception {
        response.setContentType("application/octet-stream");

        // Content-Disposition use URLEncoder.encode
        String filename = URLEncoder.encode("下载_2024.txt", "utf8");
        response.setHeader("Content-Disposition", "attachment; filename=\"" + filename + "\"");

        // Content-Disposition specify encoding
//        String encodedFileName = URLEncoder.encode("下载_2024.txt", "UTF-8").replaceAll("\\+", "%20");
//        String contentDispositionValue = "attachment; filename*=UTF-8''" + encodedFileName;
//        response.setHeader("Content-Disposition", contentDispositionValue);

        try {
            OutputStream os = response.getOutputStream();
            os.write("1.txt".getBytes());
            os.flush();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

chrome 中下载如下可以看到文件名是正常的

safari 中下载如下, 可以看到是 URLEncoder.encode 之后的结果

问题的解决

在 Content-Disposition 中指定编码, 这样浏览器支持 RFC 5987 的话, 就可以进行正确的解码了

复制代码

        String encodedFileName = URLEncoder.encode("下载_2024.txt", "UTF-8").replaceAll("\\+", "%20");
        String contentDispositionValue = "attachment; filename*=UTF-8''" + encodedFileName;
        response.setHeader("Content-Disposition", contentDispositionValue);

safari 中下载如下, 可以看到问题解决了

完