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

教练、我想打篮球2025-12-27 12:52

前言

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

然后只有 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 中下载如下, 可以看到问题解决了

完