Tomcat环境下Java Web应用上传头像本地存储无法访问的方案咨询
问题核心原因
你遇到的加载失败本质是两个完全可定位的错误,和Blob存储、Tomcat路径配置的关系不大:
- 你直接把
C:\Users\john\Google Drive\AvatarPic\这类本地磁盘绝对路径作为图片地址塞给浏览器当img.src,受浏览器安全策略限制,网页端永远没有权限直接访问用户本地硬盘上的文件,根本不可能加载成功 - 你上传保存文件的逻辑存在逻辑错误:
for(Part part: req.getParts()){ part.write(SAVE_DIR + fileName); }会把表单里所有的文本字段(比如firstName、email这些输入项)都尝试写入你指定的图片文件路径,会产生大量损坏的文件、甚至覆盖正常的图片文件
可落地的实现方案
方案1:开发调试用——将头像存入Web应用可直接访问的静态目录
这种方案不需要额外写代码,直接利用Tomcat本身的静态资源访问机制就能实现图片加载:
- 替换硬编码的磁盘路径,在Servlet初始化时动态获取应用下的上传目录:
// 删掉原来硬编码的SAVE_DIR常量,改为动态获取 private String SAVE_DIR; @Override public void init() throws ServletException { this.userDBManagement = UserDBManagement.getInstance(); // 获取Web应用下uploads/avatars目录对应的真实磁盘路径 String uploadBasePath = getServletContext().getRealPath("/uploads/avatars"); File uploadDir = new File(uploadBasePath); // 目录不存在则自动创建 if (!uploadDir.exists()) { uploadDir.mkdirs(); } this.SAVE_DIR = uploadDir.getAbsolutePath() + File.separator; } - 修正文件保存逻辑,删掉遍历所有Part的错误代码,只单独处理头像上传的Part:
Part avatarPart = req.getPart("avatar"); // 处理文件名路径穿越问题,避免恶意构造的文件名跳出上传目录 String fileName = Paths.get(avatarPart.getSubmittedFileName()).getFileName().toString(); // 加UUID前缀避免不同用户上传的同名文件互相覆盖 String uniqueFileName = UUID.randomUUID() + "_" + fileName; // 单独写入头像文件 avatarPart.write(SAVE_DIR + uniqueFileName); - 修正数据库存储的内容:不要存磁盘绝对路径,只存Web可访问的相对路径,比如存储值为
uploads/avatars/+ 生成的uniqueFileName。当profile接口返回这个路径给前端时,前端拼接上应用的上下文路径,得到的img.src是类似/你的应用名/uploads/avatars/xxx.jpg的URL,Tomcat会自动把这个路径映射到对应的磁盘目录,浏览器可正常加载。注意:这种方案的缺陷是,每次重新打包部署war应用时,Tomcat部署目录下的原有上传文件会被清空,仅适合本地开发调试使用。
方案2:生产环境用——自定义资源Servlet读取磁盘文件
这种方案可以把头像存在任意自定义磁盘目录下,不会因为应用重新部署丢失文件,也完全绕开浏览器的本地文件访问限制:
- 你依然可以使用原来的自定义存储目录(比如
C:\Users\john\Google Drive\AvatarPic\),只需要单独写一个专门处理头像访问的Servlet,映射路径为/avatar/*:@WebServlet("/avatar/*") public class AvatarResourceServlet extends HttpServlet { // 与你实际存储头像的磁盘目录保持一致 private final String AVATAR_STORE_DIR = "C:\\Users\\john\\Google Drive\\AvatarPic\\"; @Override protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { // 从请求路径中提取要访问的头像文件名 String requestedFileName = req.getPathInfo().substring(1); File targetFile = new File(AVATAR_STORE_DIR, requestedFileName); if (!targetFile.exists()) { resp.sendError(HttpServletResponse.SC_NOT_FOUND); return; } // 设置正确的图片响应类型 resp.setContentType(getServletContext().getMimeType(targetFile.getAbsolutePath())); // 将磁盘上的图片文件以流的形式写回响应 try (InputStream fileIn = new FileInputStream(targetFile); OutputStream respOut = resp.getOutputStream()) { byte[] buffer = new byte[1024]; int readLen; while ((readLen = fileIn.read(buffer)) != -1) { respOut.write(buffer, 0, readLen); } } } } - 这时候数据库里只需要存上传生成的唯一文件名即可,profile接口返回给前端的图片地址拼接逻辑为:
应用上下文路径 + "/avatar/" + 数据库存储的文件名。浏览器请求这个URL时,会由刚才写的Servlet直接读取磁盘上的图片文件返回,完全不存在跨权限的问题。
前端代码修正点
你现有ajax逻辑里拿到数据库存的path之后,不要直接赋值给img.src:
- 对方案1的场景,需要拼接应用根路径,不要直接用磁盘路径
- 对方案2的场景,只需要拼上自定义Servlet的映射路径即可
额外的注意事项
- 不要在数据库中存储包含盘符的本地绝对路径,这类路径换个服务器、换个用户的电脑就完全失效,也无法被浏览器访问
- 上传文件时要增加文件类型校验,避免上传可执行脚本引发安全漏洞
- 必须删掉遍历所有Part写文件的逻辑,否则会持续生成大量损坏文件
内容的提问来源于stack exchange,提问作者Sorin
相关产品推荐
相关产品推荐

