Java 8/11环境下如何无写操作访问外部文件服务器的PDF文件

不管是Java 8还是Java 11，都完全可以跳过“读取外部文件→写入Web应用内部路径”的冗余步骤，直接将外部文件服务器的PDF以流的形式响应给前端，全程零中间写操作。

Java 8 原生支持的通用实现 #

核心思路是：在对外提供PDF访问的接口（Servlet/Controller）中，直接对接外部文件的输入流与HTTP响应输出流，完全不需要依赖Web应用目录的静态资源能力。
借助Java NIO的零拷贝通道能力，性能比传统逐块流读写更优，示例代码：

// 外部文件服务器的指定路径，可通过配置项灵活配置
Path pdfFilePath = Paths.get("/opt/external-file-server/pdf/report.pdf");
// 配置HTTP响应头
response.setContentType("application/pdf");
response.setContentLengthLong(Files.size(pdfFilePath));
response.setHeader("Content-Disposition", "inline; filename=report.pdf");
// 直接做通道间的数据传输，无本地文件写操作
try (
    ReadableByteChannel fileChannel = Files.newByteChannel(pdfFilePath);
    WritableByteChannel responseChannel = Channels.newChannel(response.getOutputStream())
) {
    // *底层零拷贝传输，避免用户态/内核态的冗余数据复制*
    fileChannel.transferTo(0, Long.MAX_VALUE, responseChannel);
}

整个流程不会向Web应用的部署目录写入任何临时文件，内存中也不会缓存全量PDF内容。

Java 11 简化实现 #

Java 11 为NIO新增了更便捷的重载方法，不需要手动创建通道即可完成文件到响应流的传输，代码更简洁：

Path pdfFilePath = Paths.get("/opt/external-file-server/pdf/report.pdf");
response.setContentType("application/pdf");
response.setHeader("Content-Disposition", "inline; filename=report.pdf");
// 自动处理流关闭、异常处理，内部同样基于零拷贝实现
Files.copy(pdfFilePath, response.getOutputStream());

零代码改造的适配方案（Web框架场景） #

如果你的Web应用使用Spring、Spring Boot这类框架，甚至不需要编写流处理的业务代码，只需要配置静态资源映射，将外部文件服务器的路径映射为Web应用的虚拟访问路径即可。
以Spring Boot配置为例：

spring:
  web:
    resources:
      # 把外部文件服务器路径加入静态资源搜索范围
      static-locations: classpath:/static/, file:/opt/external-file-server/

配置完成后，前端直接访问/pdf/report.pdf路径，Web服务器就会自动从外部文件服务器的对应路径读取PDF返回给用户，全程无任何文件拷贝到Web应用内部目录的操作。

实现注意事项 #

• 无论用哪种实现，都必须对传入的文件路径参数做合法性校验，禁止直接拼接用户可控的相对路径，避免../类的路径穿越安全漏洞。
• 零拷贝的实现方式适合大文件传输场景，不会因为PDF文件过大导致Web应用内存溢出。

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