当前位置：首页 > news >正文

springboot的项目实现excel上传功能

news 2025/9/17 5:45:05

在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>
```