Spring Boot项目DocumentWeb浏览器运行报500错误求助

我正在学习Spring Boot，开发了一个名为DocumentWeb的Web项目，包含Controller、JSP、实体类Document以及继承JpaRepository的DocumentRepository接口。项目需要实现图片上传、下载功能，将图片以Blob形式存储到数据库，但浏览器运行时出现500错误。注释掉Controller中对DocumentRepository的调用逻辑后，项目可正常启动，代码无明显编译报错，求排查问题。

核心问题点分析 #

1. JSP表单文件上传参数名不匹配 #

DocumentUpload.jsp的表单中，文件输入框的name属性错误设为id，但Controller的uploadDocument方法中接收文件的参数是@RequestParam("document")，参数名不匹配会导致文件无法接收，触发后续空指针或参数绑定异常。

<!-- 错误代码 -->
Document:<input type="file" name="id"/>

2. JPA查询方法过时 #

Controller的download方法使用了已过时的repository.getOne(id)，该方法在Spring Data JPA 3.x（对应Spring Boot 3.x）中已被标记为过时，且内部实现可能引发NoResultException，导致500错误。

// 错误代码
Document document = repository.getOne(id);

3. 数据库表结构可能不匹配 #

实体类Document的data字段用@Lob标记为二进制大对象，但MySQL自动生成表时，默认字段类型可能为BLOB（容量有限），无法存储较大图片，导致存储失败。

4. 缺少异常处理逻辑 #

Controller中未对文件为空、ID重复、文件读取失败等场景做异常捕获，一旦出现问题直接抛出RuntimeException，触发500错误。

修复方案 #

1. 修正JSP表单参数名 #

将文件输入框的name改为document，与Controller参数名匹配：

<!-- 修正后 -->
Document:<input type="file" name="document"/>

2. 替换过时的JPA查询方法 #

使用findById(id).orElseThrow()替代getOne(id)，明确处理文件不存在的情况：

// 修正后
Document document = repository.findById(id)
        .orElseThrow(() -> new RuntimeException("未找到ID为" + id + "的文件"));

3. 确保数据库表结构正确 #

在application.properties中添加JPA自动更新表结构的配置，让框架生成正确的LONGBLOB类型字段：

spring.jpa.hibernate.ddl-auto=update

4. 添加文件上传大小限制（可选） #

避免因图片过大导致上传失败，在application.properties中配置：

spring.servlet.multipart.max-file-size=10MB
spring.servlet.multipart.max-request-size=10MB

5. 完善异常处理逻辑 #

在上传方法中添加参数校验和异常捕获，返回友好提示：

@RequestMapping(value="/upload", method = RequestMethod.POST)
public String uploadDocument(@RequestParam("document") MultipartFile multipartFile, 
                             @RequestParam("id") Long id, 
                             ModelMap modelMap) {
    if (multipartFile.isEmpty()) {
        modelMap.addAttribute("error", "请选择要上传的文件");
        extracted(modelMap);
        return "DocumentUpload";
    }
    if (repository.existsById(id)) {
        modelMap.addAttribute("error", "该ID已存在，请更换");
        extracted(modelMap);
        return "DocumentUpload";
    }
    Document document = new Document();
    document.setId(id);
    document.setName(multipartFile.getOriginalFilename());
    try {
        document.setData(multipartFile.getBytes());
    } catch (IOException e) {
        modelMap.addAttribute("error", "文件读取失败：" + e.getMessage());
        extracted(modelMap);
        return "DocumentUpload";
    }
    repository.save(document);
    modelMap.addAttribute("success", "文件上传成功");
    extracted(modelMap);
    return "DocumentUpload";
}

修正后的关键代码片段 #

修正后的DocumentUpload.jsp #

<%@ page language="java" contentType="text/html; charset=ISO-8859-1"
         pageEncoding="ISO-8859-1"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@page isELIgnored="false" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
    <title>Document Upload</title>
</head>
<h3>Upload A Photo</h3>
<body>
<c:if test="${not empty error}">
    <p style="color:red">${error}</p>
</c:if>
<c:if test="${not empty success}">
    <p style="color:green">${success}</p>
</c:if>
<form action="upload" method="post" enctype="multipart/form-data">
    <pre>
        Id:<input type="text" name="id"/>
        Document:<input type="file" name="document"/>
        <input type="submit" value="Upload"/>
        <input type="reset" value="refresh"/>
    </pre>
</form>
<table>
    <tr>
        <th>id</th>
        <th>name</th>
        <th>link</th>
    </tr>
    <c:forEach items="${documents}" var="document">
        <tr>
            <td>${document.id}</td>
            <td>${document.name}</td>
            <td><a href="download?id=${document.id}">download</a></td>
        </tr>
    </c:forEach>
</table>
</body>
</html>

修正后的DocumentController #

package com.javaMadeEasy.document.controllers;

import com.javaMadeEasy.document.entities.Document;
import com.javaMadeEasy.document.repository.DocumentRepository;
import jakarta.servlet.http.HttpServletResponse;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.ModelMap;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.multipart.MultipartFile;
import org.springframework.web.servlet.mvc.method.annotation.StreamingResponseBody;

import java.io.IOException;
import java.util.List;

@Controller
public class DocumentController {
    @Autowired
    DocumentRepository repository;

    @RequestMapping("/displayUpload")
    public String displayUpload(ModelMap modelMap){
        extracted(modelMap);
        return "DocumentUpload";
    }

    @RequestMapping(value="/upload", method = RequestMethod.POST)
    public String uploadDocument(@RequestParam("document") MultipartFile multipartFile, 
                                 @RequestParam("id") Long id, 
                                 ModelMap modelMap) {
        if (multipartFile.isEmpty()) {
            modelMap.addAttribute("error", "请选择要上传的文件");
            extracted(modelMap);
            return "DocumentUpload";
        }
        if (repository.existsById(id)) {
            modelMap.addAttribute("error", "该ID已存在，请更换");
            extracted(modelMap);
            return "DocumentUpload";
        }
        Document document = new Document();
        document.setId(id);
        document.setName(multipartFile.getOriginalFilename());
        try {
            document.setData(multipartFile.getBytes());
        } catch (IOException e) {
            modelMap.addAttribute("error", "文件读取失败：" + e.getMessage());
            extracted(modelMap);
            return "DocumentUpload";
        }
        repository.save(document);
        modelMap.addAttribute("success", "文件上传成功");
        extracted(modelMap);
        return "DocumentUpload";
    }

    @RequestMapping("/download")
    public StreamingResponseBody download(@RequestParam("id") long id, HttpServletResponse response){
        Document document = repository.findById(id)
                .orElseThrow(() -> new RuntimeException("未找到ID为" + id + "的文件"));
        byte[] data = document.getData();
        response.setHeader("Content-Disposition","attachment;filename=" + document.getName());
        return outputStream -> {
            outputStream.write(data);
        };
    }

    private void extracted(ModelMap modelMap) {
        List<Document> documents = repository.findAll();
        modelMap.addAttribute("documents",documents);
    }
}

内容的提问来源于stack exchange，提问作者Sammie