springboot项目中文件的下载(解决中文乱码问题)

本文解决了SpringBoot项目中导出Excel文件时遇到的中文文件名乱码问题及路径报错问题,通过调整编码方式和使用类加载器直接获取资源作为输入流来实现。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

最近使用springboot项目,一直以来文件都以英文格式存储,这次使用的是xls文件下载,文件名为中文的,特此记录下中文文件名的下载以及springboot中下载路径报错问题。

正文

在使用springboot导出excel的时候,出现了两个问题:如下

1. 导出的时候中文名乱码问题

如:鑱旂綉鍗煎叆妯℃澘.xlsx

2. 导出的时候springboot路径问题:在jar项目后会默认多一个!,导致路径错误。

具体实现思路是:

首先拿到文件名,然后拿到父路径和文件名,创建一个File,然后将此file使用response写出到客户端。对于获取父路径:使用的是类的加载器,getResource(“name”)得到的URL对象,然后获取的url.getPath(),这就造成了获取File时候创建的路径多了个!。

之后进行更改,因为获取File文件之后还是需要拿到InputStream。所以这里直接使用的是:类的加载器直接获取资源作为InputStream

接下来就是解决乱码问题:

名字进行重新编码:

然后设置一些相应类型和响应头:将流作为相应

完整版代码如下:

 String file_name = "用户导入模板.xlsx";
        try{
            OutputStream os = response.getOutputStream();
            String fileName = new String(file_name.getBytes("GBK"),"ISO-8859-1");
            InputStream is = this.getClass().getClassLoader().getResourceAsStream("excelTemplate/" + file_name);
            response.setContentType("application/force-download");
            response.addHeader("Content-Disposition","attachment;fileName=" + fileName);
            int len = 0;
            byte[] b = new byte[1024];
            while ((len = is.read(b, 0, b.length)) != -1) {
                os.write(b, 0, len);
            }
        } catch (IOException e) {
            e.printStackTrace();
        }

这样就可以下载文件了并且不会出现乱码。

 

 

 目前还没有遇到别的问题,有别的问题在更新。

 

2018-08-27更新:

在最近使用下载的时候,发现转来转去的编码比较麻烦,发现了一个 URLEncoder.encode(fileName,"UTF-8") 的方法,特此记录下。

 String fileName = path.substring(path.lastIndexOf("\\") +1 ,path.length());
        File file = new File(path);
        if (!file.exists()){
            logger.error("路径有误,文件不存在!");
        }
        //new String(fileName.getBytes("UTF-8"),"ISO-8859-1");
        response.setHeader("content-disposition","attachment;filename=" + URLEncoder.encode(fileName,"UTF-8"));
        response.setContentType("content-type:octet-stream");
        BufferedInputStream inputStream = new BufferedInputStream(new FileInputStream(file));
        OutputStream outputStream = response.getOutputStream();
        byte[] buffer = new byte[1024];
        int len = 0 ;
        while ((len = inputStream.read(buffer)) != -1){
            outputStream.write(buffer ,0 , len);
        }
        inputStream.close();
        outputStream.close();

使用 URLEncoder.encode(fileName,"UTF-8"),将编码转换为utf-8编码。

<think>嗯,用户遇到了Spring Boot配置文件中出现中文乱码问题,我需要帮他们解决。首先,我应该回忆一下常见的乱码原因。通常,乱码问题可能与文件编码、IDE设置或者Spring Boot本身的配置有关。 首先想到的是检查配置文件的编码格式。用户可能用的是IntelliJ IDEA或者Eclipse,不同的IDE默认编码可能不同。如果文件保存为GBK或者其他非UTF-8编码,而Spring Boot默认用UTF-8读取,就会出现乱码。所以需要确认配置文件是否使用UTF-8编码,特别是application.properties或application.yml。 然后,可能需要检查IDE的设置。比如在IDEA中,有没有将项目文件编码设置为UTF-8,包括全局编码和项目编码。还有.properties文件在IDEA中默认使用的是ISO-8859-1,这样如果有中文,就需要转义或者修改设置。 另外,Spring Boot的配置文件中,如果是.properties文件,处理中文可能需要用Unicode转义。或者,用户可能没有配置正确的字符处理过滤器,比如CharacterEncodingFilter,来确保请求和响应的编码正确。 还有可能是应用的HTTP编码设置问题。在application.properties中,可能需要设置server.servlet.encoding相关的属性,强制使用UTF-8。 另外,如果用户使用的是YAML文件,那么.yml文件本身对编码更友好,但同样需要确认保存为UTF-8,并且没有BOM头,因为BOM有时会导致问题。 可能需要分步骤来解决:首先检查文件编码,然后调整IDE设置,接着处理配置文件中的转义,最后检查Spring Boot的HTTP编码配置。如果用户已经尝试了这些步骤但问题依旧,可能需要考虑其他因素,比如数据库连接的编码设置,或者第三方库的配置。 然后,生成相关问题的时候,可能需要包括如何设置文件编码、如何处理.properties中的中文、YAML和Properties文件的区别,以及如何全局配置字符编码等问题。这样用户可以根据自己的情况进一步查找解决方案。</think>### Spring Boot配置文件中文乱码解决方案 ### 一、问题原因分析 1. **文件编码不匹配**:配置文件未使用UTF-8编码保存,导致中文字符被错误解析 2. **IDE编码设置错误**:开发工具(如IntelliJ IDEA)未正确配置项目文件编码 3. **Spring Boot默认配置限制**:.properties文件默认使用ISO-8859-1编码[^1] ### 二、具体解决步骤 #### 1. 检查文件编码 - 在IDE中查看配置文件编码: - IntelliJ IDEA:右下角状态栏显示当前文件编码 - Eclipse:右键文件 > Properties > Resource > Text file encoding - **强制使用UTF-8**: ```properties # application.properties spring.http.encoding.charset=UTF-8 spring.http.encoding.enabled=true spring.http.encoding.force=true ``` #### 2. 配置IDE编码(以IntelliJ为例) ```bash File > Settings > Editor > File Encodings - Global Encoding: UTF-8 - Project Encoding: UTF-8 - Default encoding for properties files: UTF-8 ✅ - 勾选"Transparent native-to-ascii conversion" ``` #### 3. 处理.properties文件中文 - **方案一:使用Unicode转义** ```properties welcome.message=\u4E2D\u6587\u6D4B\u8BD5 ``` - **方案二:开启native2ascii自动转换** ```xml <!-- pom.xml --> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-resources-plugin</artifactId> <configuration> <encoding>UTF-8</encoding> <useDefaultDelimiters>true</useDefaultDelimiters> </configuration> </plugin> ``` #### 4. 使用YAML替代Properties ```yaml # application.yml server: port: 8080 servlet: encoding: charset: UTF-8 enabled: true force: true welcome: "中文测试" ``` > YAML格式原生支持UTF-8编码,建议优先使用 #### 5. 验证配置生效 ```java @RestController public class TestController { @Value("${welcome}") private String welcome; @GetMapping("/test") public String test() { return welcome; // 应正确显示中文 } } ``` ### 三、补充优化建议 - 在启动类中添加字符过滤器: ```java @Bean public FilterRegistrationBean<CharacterEncodingFilter> filterRegistrationBean() { FilterRegistrationBean<CharacterEncodingFilter> registration = new FilterRegistrationBean<>(); registration.setFilter(new CharacterEncodingFilter()); registration.addInitParameter("encoding", "UTF-8"); registration.addInitParameter("forceEncoding", "true"); registration.addUrlPatterns("/*"); return registration; } ``` - 检查数据库连接配置: ```properties spring.datasource.url=jdbc:mysql://localhost:3306/db?useUnicode=true&characterEncoding=UTF-8 ```
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值