spring boot csv文件上传到后端乱码

原创

mob64ca12da726f 2024-09-30 05:28:44 ©著作权

文章标签 CSV 文件上传上传 文章分类 spring boot 后端开发

©著作权归作者所有：来自51CTO博客作者mob64ca12da726f的原创作品，请联系作者获取转载授权，否则将追究法律责任

Spring Boot 文件上传与 CSV 乱码问题解决

在现代的 web 应用中，文件上传是一个非常重要的功能。今天，我们将一起学习如何使用 Spring Boot 实现 CSV 文件的上传，并解决文件乱码的问题。以下是整件事情的流程。

流程概览

下面是一个简要的流程表，说明实现 CSV 文件上传的步骤：

步骤	操作
1. 创建 Spring Boot 项目	初始化项目结构
2. 添加依赖	添加必要的依赖库
3. 创建 Controller	处理文件上传逻辑
4. 解析 CSV	读取并解析 CSV 文件
5. 解决乱码问题	设置适当的编码
6. 测试功能	验证上传功能是否正常

每一步详细说明

1. 创建 Spring Boot 项目

首先，我们可以使用 Spring Initializr 来创建一个新的 Spring Boot 项目。

访问 [Spring Initializr](
选择项目元数据：选择 Maven 或 Gradle 作为构建工具，选择 Java 版本。
在 Dependencies 菜单中，添加 Spring Web、Spring Boot DevTools 依赖。
点击 "Generate" 下载项目，并解压。

2. 添加依赖

在 pom.xml 文件中添加 CSV 解析库，通常我们可以使用 OpenCSV：

<dependency>
    <groupId>com.opencsv</groupId>
    <artifactId>opencsv</artifactId>
    <version>5.5.2</version>
</dependency>

这段代码引入了 OpenCSV 库，它将帮助我们处理 CSV 文件。

3. 创建 Controller

接下来，我们创建一个控制器来处理文件上传的请求。

import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;
import org.springframework.stereotype.Controller;
import java.io.IOException;

@Controller
public class FileUploadController {

    @PostMapping("/upload")
    public String handleFileUpload(@RequestParam("file") MultipartFile file) {
        // 检查文件是否为空
        if (file.isEmpty()) {
            return "文件为空";
        }
        
        // 继续处理文件
        try {
            // 调用文件解析逻辑
            parseCsvFile(file);
        } catch (IOException e) {
            e.printStackTrace();
            return "文件解析失败";
        }

        return "成功";
    }
    
    private void parseCsvFile(MultipartFile file) throws IOException {
        // 本方法将在稍后实现
    }
}

这段代码定义了一个文件上传接口，接收上传的 CSV 文件，并调用 parseCsvFile 方法进行解析。

4. 解析 CSV

我们可以在 parseCsvFile 方法中添加 CSV 解析的逻辑。

import com.opencsv.CSVReader;
import com.opencsv.exceptions.CsvException;

private void parseCsvFile(MultipartFile file) throws IOException {
    // 使用 InputStreamReader 指定编码为 UTF-8
    try (CSVReader csvReader = new CSVReader(new InputStreamReader(file.getInputStream(), "UTF-8"))) {
        String[] nextLine;
        // 逐行读取 CSV 文件
        while ((nextLine = csvReader.readNext()) != null) {
            // 处理每一行
            System.out.println(Arrays.toString(nextLine));
        }
    } catch (CsvException e) {
        e.printStackTrace();
    }
}

在这段代码中，我们使用 InputStreamReader 指定编码为 "UTF-8"，确保文件内容的正确解析，避免出现乱码。

5. 解决乱码问题

在上传和读取过程中，要确保文件的编码格式正确。一般来说，CSV 文件应使用 UTF-8 编码。通过指定编码，我们可以避免乱码问题。如果你在读取数据后仍然碰到乱码，确认 CSV 文件的实际编码。

6. 测试功能

我们可以使用 Postman 工具对文件上传功能进行测试：

启动 Spring Boot 应用。
在 Postman 中选择 POST 请求。
选择文件上传，并上传 CSV 文件。
点击发送请求，检查返回结果。

如果一切正常，你将在控制台中看到 CSV 文件中每行的内容。

状态图

下面是整个上传与解析过程的状态图：

stateDiagram
    [*] --> 开始
    开始 --> 文件上传
    文件上传 --> 文件有效
    文件有效 --> 解析CSV文件
    解析CSV文件 --> 处理每行数据
    处理每行数据 --> [*]
    文件上传 --> 文件为空
    文件上传 --> 上传失败
    文件为空 --> [*]
    上传失败 --> [*]