Maven资源过滤致文件损坏+JSF下载PDF遇问题求助

一、前端直接访问方案（无需后端代码） #

这是最简洁的静态资源下载方案，推荐优先使用：

1. 调整文件存放位置
   将manual.pdf移动到webapp根目录下（即src/main/webapp/manual.pdf），不要放在WEB-INF或src/main/resources中：

   • WEB-INF是服务器受保护目录，前端无法直接访问；
   • src/main/resources下的文件会被打包到WEB-INF/classes，同样无法通过前端URL直接访问。

2. 使用正确的链接标签
   不管用JSF标签还是普通HTML标签，都要带上应用上下文路径，避免相对路径错误：

   • JSF的<h:outputLink>写法：

     <h:outputLink value="#{request.contextPath}/manual.pdf" target="_blank">
       Download
     </h:outputLink>
     

   • 普通HTML的<a>标签写法（效果完全一致）：

     <a href="#{request.contextPath}/manual.pdf" target="_blank">Download</a>
     

   加上#{request.contextPath}可以确保路径不受当前页面的视图层级影响，始终指向应用根目录下的PDF文件。

二、修复Maven资源过滤问题（若需保留PDF在src/main/resources） #

如果你坚持要把PDF放在src/main/resources，需要调整Maven配置，既避免二进制文件被过滤损坏，又确保文件被打包进war包：

你之前的配置只排除了PDF的过滤，但没有把PDF纳入打包范围，导致war中缺失文件。修改pom.xml的<resources>节点如下：

<resources>
  <!-- 对文本类资源开启过滤（比如properties配置文件） -->
  <resource>
    <filtering>true</filtering>
    <directory>src/main/resources</directory>
    <excludes>
      <exclude>**/*.pdf</exclude>
      <!-- 可添加其他二进制文件类型，避免过滤损坏 -->
      <exclude>**/*.png</exclude>
      <exclude>**/*.jpg</exclude>
    </excludes>
  </resource>
  <!-- 对二进制资源关闭过滤，保证文件完整性 -->
  <resource>
    <filtering>false</filtering>
    <directory>src/main/resources</directory>
    <includes>
      <include>**/*.pdf</include>
      <!-- 对应上面的二进制文件类型 -->
    </includes>
  </resource>
</resources>

此时PDF会被打包到WEB-INF/classes下，但前端无法直接访问该目录，需要写一个简单的后端接口来返回文件（以Spring控制器为例）：

@Controller
public class DownloadController {
    @GetMapping("/downloadManual")
    public ResponseEntity<Resource> downloadManual() throws IOException {
        Resource resource = new ClassPathResource("manual.pdf");
        return ResponseEntity.ok()
                .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + resource.getFilename() + "\"")
                .contentType(MediaType.APPLICATION_PDF)
                .body(resource);
    }
}

然后前端链接指向该接口即可：

<h:outputLink value="#{request.contextPath}/downloadManual" target="_blank">
  Download
</h:outputLink>

三、你之前的标签失效原因 #

• <h:link>：这个标签是用于JSF内部导航的，会遵循JSF导航规则处理路径，而非直接指向静态资源，所以会出现重定向到首页的问题，不适合下载静态文件。
• <h:outputLink>：你之前的写法未携带上下文路径，如果当前页面URL是/app/foo/page.xhtml，相对路径manual.pdf会被解析为/app/foo/manual.pdf，但你的文件实际不在该位置，因此出现404错误。

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