Servlet文件上传路径选型及JSP访问Tomcat webapp外文件方案咨询

嘿，我来帮你搞定这两个问题，这都是Servlet文件上传场景里非常常见的痛点，我之前做项目的时候也踩过类似的坑，分享下实用的解决方案：

1. 适合永久存储上传文件的推荐路径 #

绝对不要把文件存在Tomcat的webapp目录、bin目录或者应用的部署包（WAR/JAR）里，这些位置都会在重新部署、重启Tomcat或者更新应用时被覆盖或清空。推荐的路径有这些：

• 服务器上的独立专用目录：比如在Linux系统上可以用/opt/app-uploads/，Windows系统用D:\app-uploads\。这个目录完全独立于Tomcat和你的Web应用，不管怎么部署、重启，文件都不会丢失，还方便单独做备份、扩容或者权限管理。
• 通过配置文件动态指定路径：不要在代码里硬编码路径，而是把路径写在配置文件（比如upload.properties）里，然后在Servlet中读取配置。比如配置项upload.dir=/opt/app-uploads/，这样后期要改路径只需要改配置文件，不用修改代码重新部署。
• 专业的文件存储服务：如果你的应用是生产环境且文件量很大，推荐用对象存储服务（比如MinIO这类），不过这个属于进阶方案，小项目用本地独立目录就足够了。

2. 在JSP页面访问Tomcat webapp目录外的视频/图片 #

有两种常用的方法，根据你的需求选：

方法一：配置Tomcat虚拟上下文路径 #

这是最简单的静态文件访问方式，通过Tomcat的配置把外部目录映射成一个可通过URL访问的路径：

1. 推荐在conf/Catalina/localhost下新建单独的XML文件（比如uploads.xml），避免修改全局server.xml带来的风险
2. 写入配置内容：

<Context docBase="/opt/app-uploads" path="/uploads" reloadable="true" />

• docBase：你的外部文件存储目录的绝对路径
• path：访问这个目录的URL前缀，比如配置后，你存储的cat.jpg就可以通过http://your-domain/uploads/cat.jpg访问

3. 重启Tomcat后，在JSP里直接用普通的<img>或<video>标签即可：

<img src="/uploads/cat.jpg" alt="猫咪图片">
<video src="/uploads/demo.mp4" controls></video>

方法二：编写代理Servlet动态输出文件 #

如果需要对文件访问做权限控制（比如只允许登录用户查看），或者不想修改Tomcat全局配置，就可以写一个专门的Servlet来代理外部文件：

1. 创建一个FileProxyServlet，核心代码示例：

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    // 获取请求的文件名
    String fileName = request.getParameter("file");
    // 你的外部存储目录（建议从配置文件读取，不要硬编码）
    String uploadDir = "/opt/app-uploads/";
    File file = new File(uploadDir + fileName);

    if (!file.exists()) {
        response.sendError(HttpServletResponse.SC_NOT_FOUND);
        return;
    }

    // 设置正确的Content-Type，比如图片是image/jpeg，视频是video/mp4
    String contentType = getServletContext().getMimeType(file.getName());
    response.setContentType(contentType);

    // 输出文件到响应流
    try (InputStream in = new FileInputStream(file);
         OutputStream out = response.getOutputStream()) {
        byte[] buffer = new byte[4096];
        int bytesRead;
        while ((bytesRead = in.read(buffer)) != -1) {
            out.write(buffer, 0, bytesRead);
        }
    }
}

2. 在web.xml里配置这个Servlet的映射：

<servlet>
    <servlet-name>FileProxyServlet</servlet-name>
    <servlet-class>com.yourpackage.FileProxyServlet</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>FileProxyServlet</servlet-name>
    <url-pattern>/file/*</url-pattern>
</servlet-mapping>

3. 在JSP里通过这个Servlet访问文件：

<img src="/file?file=cat.jpg" alt="猫咪图片">
<video src="/file?file=demo.mp4" controls></video>

这种方法的好处是可以在Servlet里加权限校验、日志记录等逻辑，更灵活。

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