为何JSP需重启Tomcat才能读取webapp/images目录下生成的图片？

你遇到的问题本质是Java Web服务器（如Tomcat）在启动时会对webapp目录下的静态资源做缓存或建立访问映射，启动后新增的静态资源不会被自动识别——哪怕你已经生成了图片，服务器也没把它加入可访问的资源列表，只有重启才会重新扫描所有资源。

方案1：图片存到webapp外部目录，配置虚拟路径映射 #

这是生产环境最常用的方案，彻底规避服务器静态资源缓存问题：

• 第一步：修改Servlet的图片生成路径，把图片写到服务器外部的独立目录，比如D:/web_puzzle_images/subimages/，替换原来的webapp/images路径：

  // 示例代码，替换你原来的ImageIO.write路径逻辑
  File saveDir = new File("D:/web_puzzle_images/subimages");
  if (!saveDir.exists()) {
      saveDir.mkdirs();
  }
  File outputFile = new File(saveDir, "subimage_0.jpg");
  ImageIO.write(image, "jpg", outputFile);
  

• 第二步：配置虚拟路径映射，让服务器把/subimages请求指向外部目录。推荐在项目的META-INF/context.xml里配置（不用修改Tomcat全局配置）：

  <Context>
      <Resources>
          <PreResources 
              base="D:/web_puzzle_images/subimages" 
              className="org.apache.catalina.webresources.DirResourceSet" 
              webAppMount="/subimages" 
          />
      </Resources>
  </Context>
  

  配置后，JSP里的src="subimages/subimage_0.jpg"路径完全不用改，生成图片后刷新页面就能直接访问。

方案2：通过Servlet动态输出图片 #

如果不想修改存储路径，写一个专门的Servlet读取并输出图片，绕过静态资源缓存机制：

• 第一步：编写ImageServlet：

  @WebServlet("/getImage")
  public class ImageServlet extends HttpServlet {
      @Override
      protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
          String imgName = request.getParameter("name");
          if (imgName == null || imgName.isEmpty()) {
              response.sendError(HttpServletResponse.SC_BAD_REQUEST);
              return;
          }
          // 获取webapp下的图片实际存储路径
          String realPath = getServletContext().getRealPath("/images/subimages/") + imgName;
          File imgFile = new File(realPath);
          
          if (imgFile.exists()) {
              response.setContentType("image/jpeg");
              // 流方式输出图片
              try (InputStream in = new FileInputStream(imgFile);
                   OutputStream out = response.getOutputStream()) {
                  byte[] buffer = new byte[1024];
                  int len;
                  while ((len = in.read(buffer)) != -1) {
                      out.write(buffer, 0, len);
                  }
              }
          } else {
              response.sendError(HttpServletResponse.SC_NOT_FOUND);
          }
      }
  }
  

• 第二步：修改JSP里的图片路径：

  <figure>
      <img src="getImage?name=subimage_0.jpg" height="144" width="256">
  </figure>
  <figure>
      <img src="getImage?name=subimage_1.jpg" height="144" width="256">
  </figure>
  

  每次请求图片时，Servlet都会直接读取最新生成的文件，刷新页面就能看到效果。

不推荐的方案：开启服务器静态资源自动扫描 #

如果一定要把图片存在webapp目录下，可以修改Tomcat配置让它自动扫描资源变化，但会增加服务器性能开销，不适合生产环境：

• 在Tomcat的conf/context.xml中，给<Context>标签添加resourcesCacheMaxSize="0"，禁用静态资源缓存：

  <Context resourcesCacheMaxSize="0">
      <!-- 其他配置 -->
  </Context>
  

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