SpringBoot项目实现Excel上传功能的示例代码

2025-09-17 09:44:18 作者：悟能不能悟

这篇文章主要为大家详细介绍了SpringBoot项目中实现Excel上传功能的相关方法,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下

在Spring Boot项目中实现Excel上传功能，可以通过以下步骤完成。这里使用Apache POI库处理Excel文件，并结合Spring MVC的文件上传功能。

步骤 1：添加依赖

在pom.xml中添加以下依赖：

<!-- Spring Boot Web -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<!-- Apache POI for Excel -->
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi</artifactId>
    <version>5.2.3</version> <!-- 使用最新版本 -->
</dependency>
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.3</version>
</dependency>

步骤 2：配置文件上传

在application.properties中添加：

# 文件上传大小限制
spring.servlet.multipart.max-file-size=10MB
spring.servlet.multipart.max-request-size=10MB

步骤 3：创建实体类

假设Excel包含用户数据：

public class User {
    private String name;
    private Integer age;
    private String email;
    
    // Getters and Setters
}

步骤 4：实现Excel解析工具类

import org.apache.poi.ss.usermodel.*;
import org.springframework.web.multipart.MultipartFile;
import java.util.ArrayList;
import java.util.List;

public class ExcelUtil {
    
    public static List<User> parseExcelFile(MultipartFile file) throws Exception {
        List<User> users = new ArrayList<>();
        
        Workbook workbook = WorkbookFactory.create(file.getInputStream());
        Sheet sheet = workbook.getSheetAt(0); // 获取第一个工作表
        
        for (Row row : sheet) {
            if (row.getRowNum() == 0) continue; // 跳过表头
            
            User user = new User();
            user.setName(getStringValue(row.getCell(0)));
            user.setAge(getIntValue(row.getCell(1)));
            user.setEmail(getStringValue(row.getCell(2)));
            
            users.add(user);
        }
        workbook.close();
        return users;
    }
    
    private static String getStringValue(Cell cell) {
        return cell == null ? "" : cell.getStringCellValue();
    }
    
    private static Integer getIntValue(Cell cell) {
        return cell == null ? null : (int) cell.getNumericCellValue();
    }
}

步骤 5：创建Controller

import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;

@RestController
@RequestMapping("/api/excel")
public class ExcelUploadController {

    @PostMapping("/upload")
    public ResponseEntity<String> uploadExcel(@RequestParam("file") MultipartFile file) {
        if (file.isEmpty()) {
            return ResponseEntity.badRequest().body("文件为空");
        }
        
        try {
            List<User> users = ExcelUtil.parseExcelFile(file);
            // 这里处理业务逻辑（如保存到数据库）
            // userService.saveUsers(users);
            return ResponseEntity.ok("成功导入 " + users.size() + " 条数据");
        } catch (Exception e) {
            return ResponseEntity.internalServerError().body("导入失败: " + e.getMessage());
        }
    }
}

步骤 6：前端调用示例（HTML）

<form action="/api/excel/upload" method="post" enctype="multipart/form-data">
    <input type="file" name="file" accept=".xlsx, .xls">
    <button type="submit">上传Excel</button>
</form>

高级优化建议

异步处理：

@Async
public void processExcelAsync(MultipartFile file) {
    // 耗时操作
}

批量插入数据库：

// 使用JPA批量保存
@Transactional
public void saveUsers(List<User> users) {
    userRepository.saveAll(users);
}

验证Excel格式：

if (!file.getOriginalFilename().endsWith(".xlsx")) {
    throw new IllegalArgumentException("仅支持.xlsx格式");
}

使用监听器模式（大文件处理）：

考虑使用EasyExcel库（阿里开源）处理百万级数据：

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>3.3.2</version>
</dependency>

处理流程

前端提交表单 →
Controller接收文件 →
工具类解析Excel →
转换为对象列表 →
执行业务逻辑（如存入数据库）

常见问题解决

乱码问题：确保Excel保存为UTF-8格式
日期格式：使用DateUtil.getJavaDate(cell.getNumericCellValue())
内存溢出：对大文件使用SXSSFWorkbook或EasyExcel的流式读取

通过以上实现，你可以快速在Spring Boot项目中集成Excel上传功能，并根据实际需求扩展数据处理逻辑。

到此这篇关于SpringBoot项目实现Excel上传功能的示例代码的文章就介绍到这了,更多相关SpringBoot Excel上传内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！