Java图片上传与展示实现教程

答案：通过Spring Boot结合MultipartFile实现图片上传，配置静态资源映射或控制器返回图片流以实现展示功能。具体包括添加Web依赖，编写上传接口并处理文件重命名、类型校验与大小限制，将文件存储至外部目录，配置静态资源路径或动态接口供前端访问，同时前端使用form-data提交文件并测试各类边界情况，确保功能稳定安全。

在Java Web开发中，实现图片上传与展示功能是很多项目的基础需求，比如用户头像、商品图片、内容配图等场景。下面是一个实用的开发实践指南，帮助你快速搭建稳定可靠的图片上传与展示功能。

1. 图片上传功能实现

图片上传的核心是接收前端传来的文件数据，并将其保存到服务器或指定存储位置。

使用Spring Boot + MultipartFile实现文件接收：

@PostMapping("/upload")
public ResponseEntity uploadImage(@RequestParam("file") MultipartFile file) {
    if (file.isEmpty()) {
        return ResponseEntity.badRequest().body("文件不能为空");
    }

    String uploadDir = "uploads/";
    Path path = Paths.get(uploadDir + file.getOriginalFilename());

    try {
        Files.write(path, file.getBytes());
        return ResponseEntity.ok("上传成功，路径: " + path.toAbsolutePath());
    } catch (IOException e) {
        return ResponseEntity.status(500).body("上传失败");
    }
}

• 配置文件大小限制：在application.yml中设置：

spring:
   servlet:
     multipart:
       max-file-size: 10MB
       max-request-size: 10MB

2. 图片存储路径与安全处理

直接将文件存放在项目根目录存在风险，建议采用以下策略：

• 将上传目录设在项目外部，如 /var/uploads 或 D:/uploads，避免重新部署时丢失文件。
• 对上传文件重命名，防止覆盖和路径注入攻击。可使用UUID生成唯一文件名：

String fileName = UUID.randomUUID() + "_" + file.getOriginalFilename();

• 校验文件类型，只允许图片格式（jpg、png、gif等），可通过content-type或文件头判断。
• 限制文件大小，防止恶意大文件上传耗尽服务器资源。

3. 图片展示功能实现

上传后的图片需要通过HTTP接口对外提供访问。

• 方式一：配置静态资源映射（推荐用于开发或小规模应用）

在Spring Boot中添加配置：

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/images/**")
            .addResourceLocations("file:uploads/");
    }
}

之后可通过 http://localhost:8080/images/xxx.jpg 访问图片。

• 方式二：通过Controller动态返回图片流（适合权限控制场景）

@GetMapping("/image/{filename}")
public ResponseEntity getImage(@PathVariable String filename) throws IOException {
    Path path = Paths.get("uploads/" + filename);
    if (!Files.exists(path)) {
        return ResponseEntity.notFound().build();
    }

    Resource resource = new UrlResource(path.toUri());
    String contentType = Files.probeContentType(path);

    return ResponseEntity.ok()
        .contentType(MediaType.parseMediaType(contentType))
        .body(resource);
}

4. 前端配合与测试

前端可以使用form-data提交文件，示例HTML表单：

也可用Ajax或fetch上传，便于处理响应和进度条。

测试时注意检查：
- 文件是否正确保存
- 文件名是否唯一
- 图片能否正常访问
- 异常情况（空文件、超大文件、非图片文件）是否妥善处理

基本上就这些。整个流程不复杂但容易忽略细节，尤其是安全和路径管理。按上述步骤操作，就能在Java项目中稳定实现图片上传与展示功能。