如何为Tomcat应用外的本地文件生成可访问的下载URL？

你直接用本地绝对路径作为URL肯定没法工作，Tomcat的Web应用默认只能访问自身部署目录（比如webapps/mysite）下的资源，外部的本地文件无法直接通过URL映射访问。下面给你两种靠谱的解决方案：

方法一：通过Servlet处理文件下载（推荐，灵活且安全） #

这是最常用的方式，通过编写一个简单的Servlet来读取本地文件，并将内容输出到浏览器，触发下载行为。

1. 创建一个Servlet类，比如FileDownloadServlet：

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.*;

@WebServlet("/download/guia-transporte")
public class FileDownloadServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // 目标文件的本地绝对路径
        String filePath = "C:/Users/ANTONI~1.ROQ/AppData/Local/Temp/BPCCU/GuiaTransporte.pdf";
        File targetFile = new File(filePath);

        // 检查文件是否存在，避免报错
        if (!targetFile.exists()) {
            response.sendError(HttpServletResponse.SC_NOT_FOUND, "文件不存在");
            return;
        }

        // 设置响应头，告知浏览器这是下载文件
        response.setContentType("application/pdf");
        response.setHeader("Content-Disposition", "attachment; filename=\"GuiaTransporte.pdf\"");
        response.setContentLength((int) targetFile.length());

        // 将文件内容写入响应输出流
        try (InputStream fileIn = new FileInputStream(targetFile);
             OutputStream responseOut = response.getOutputStream()) {
            byte[] buffer = new byte[4096];
            int bytesRead;
            while ((bytesRead = fileIn.read(buffer)) != -1) {
                responseOut.write(buffer, 0, bytesRead);
            }
        }
    }
}

2. 把这个Servlet部署到你的mysite应用中（比如放到WEB-INF/classes目录下，或者用IDE自动部署）。

3. 部署完成后，访问这个URL就能下载文件了：
   http://localhost:8080/mysite/download/guia-transporte

方法二：配置Tomcat虚拟目录（适合批量静态文件访问） #

如果你需要访问多个本地文件，也可以给Tomcat配置一个虚拟目录，把本地文件夹映射成Web应用的一个URL路径：

1. 打开Tomcat安装目录下的conf/server.xml文件，找到<Host>标签（通常在<Engine>标签内），添加一个<Context>元素：

<Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true">
    <!-- 其他原有配置 -->
    <!-- 添加这行，映射本地文件夹到URL路径 -->
    <Context docBase="C:/Users/ANTONI~1.ROQ/AppData/Local/Temp/BPCCU" path="/mysite/temp-files" />
</Host>

2. 重启Tomcat服务器。

3. 现在你可以通过这个URL直接访问文件：
   http://localhost:8080/mysite/temp-files/GuiaTransporte.pdf

一些注意事项 #

• 路径中的短文件名（ANTONI~1.ROQ）可以替换成完整的用户名路径（比如如果你的完整用户名是Antonio Roque，就写成C:/Users/Antonio Roque/AppData/Local/Temp/BPCCU/GuiaTransporte.pdf），Java代码里要注意用双反斜杠\\或者正斜杠/作为路径分隔符。
• 确保Tomcat进程拥有读取该文件的权限，否则会抛出IO异常。
• 方法二的虚拟目录配置要注意安全，不要映射包含敏感文件的目录，而且临时目录的文件可能会被系统自动清理，要确保文件在访问时存在。

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