Java怎么上传Excel？步骤代码是什么？新手怎么操作？

在Java开发中,处理Excel文件的上传是一项常见需求，尤其在数据导入、批量信息处理等场景中应用广泛，实现Excel上传功能需要综合考虑文件读取、数据解析、异常处理等多个环节，以下将从技术选型、代码实现、异常处理及优化建议等方面进行详细说明。

技术选型与依赖准备

实现Excel上传功能,通常需要借助第三方库来简化操作，Apache POI是Java领域处理Office文件的主流工具，支持.xls（Excel 2003）和.xlsx（Excel 2007+）格式，首先需在项目中添加相关依赖，以Maven为例，需引入以下坐标：

<!-- POI核心依赖 -->
<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>
<!-- POI对Excel 2007+格式的支持 -->
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-scratchpad</artifactId>
    <version>5.2.3</version>
</dependency>

若使用Spring Boot框架，可整合spring-boot-starter-web内置的MultipartFile接口，简化文件接收逻辑。

前端表单与后端接收

前端需构建支持文件上传的表单,注意设置enctype="multipart/form-data"，示例代码如下：

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

后端通过@PostMapping注解接收文件，使用MultipartFile类型参数：

@PostMapping("/upload/excel")
public String uploadExcel(@RequestParam("file") MultipartFile file) {
    // 文件处理逻辑
}

文件解析与数据提取

接收文件后,需根据文件扩展名选择解析方式，核心步骤包括：

1. 文件校验：检查文件是否为空、扩展名是否合法
2. 获取输入流：通过file.getInputStream()获取文件流
3. 创建工作簿对象：根据文件类型选择HSSFWorkbook（.xls）或XSSFWorkbook（.xlsx）
4. 遍历工作表与行：通过循环读取单元格数据

示例代码片段：

// 1. 校验文件
if (file.isEmpty() || (!file.getOriginalFilename().endsWith(".xls") 
    && !file.getOriginalFilename().endsWith(".xlsx"))) {
    throw new IllegalArgumentException("文件格式不正确");
}
// 2. 获取输入流
try (InputStream is = file.getInputStream()) {
    // 3. 创建工作簿
    Workbook workbook = file.getOriginalFilename().endsWith(".xls") 
        ? new HSSFWorkbook(is) 
        : new XSSFWorkbook(is);
    // 4. 获取第一个工作表
    Sheet sheet = workbook.getSheetAt(0);
    // 遍历行（跳过表头）
    for (int i = 1; i <= sheet.getLastRowNum(); i++) {
        Row row = sheet.getRow(i);
        if (row == null) continue;
        // 读取单元格数据（示例：读取前3列）
        String cell1 = row.getCell(0).getStringCellValue();
        double cell2 = row.getCell(1).getNumericCellValue();
        Date cell3 = row.getCell(2).getDateCellValue();
        // 数据处理逻辑（如存入数据库）
    }
} catch (IOException e) {
    throw new RuntimeException("文件解析失败", e);
}

异常处理与边界场景

实际开发中需充分考虑以下异常情况：

• 文件大小限制：通过spring.servlet.multipart.max-file-size配置项限制上传大小
• 空文件或格式错误：添加校验逻辑，避免解析异常
• 单元格类型转换：使用Cell.getCellType()判断单元格类型，避免类型不匹配错误
• 资源释放：使用try-with-resources确保流和 workbook 对象正确关闭

优化建议

1. 分页处理：对于大文件，可采用分页读取或异步处理，避免内存溢出
2. 模板校验：可预先定义Excel模板，校验表头、必填字段等
3. 数据校验：在解析过程中对数据进行格式校验（如手机号、邮箱等）
4. 进度反馈：对于大文件上传，可通过WebSocket等技术反馈处理进度

通过以上步骤,可完整实现Java环境下的Excel文件上传功能，实际开发中还需结合具体业务需求，如数据持久化、错误日志记录等，确保功能的健壮性和可维护性。