SpringBoot生成的PDF在Angular端下载后打开失败问题求助

问题排查与解决方案 #

核心问题定位 #

你当前遇到的PDF损坏问题，90%概率是前端请求配置和响应处理错误导致，其次可排查后端PDF生成逻辑是否正常。

第一步：修正前端代码错误 #

1. Service.ts错误点修正

现有代码存在3个错误：

• responseType 是HttpClient的请求配置项，不能放在请求头里
• 强制responseType: 'blob' as 'json'会导致二进制数据被错误序列化为JSON格式，直接损坏内容
• 配置observe: 'response'后返回的是完整HttpResponse对象，而非直接的Blob二进制数据，你后续直接把响应对象当Blob处理，必然导致文件损坏

修正后的代码：

// 直接返回Blob类型可观测对象
public customGetForDownload(params: any): Observable<Blob> {
    const headers = new HttpHeaders({ 'Content-Type': 'application/json' });
    const httpParams = this.http.constructParams(params);
    const absoluteUrl = this.getAbsoluteUrl('你的实际接口路径');
    return this.httpClient.get(absoluteUrl, {
      headers: headers,
      params: httpParams,
      responseType: 'blob' // 不需要强转，直接指定为blob类型
    });
}

如果你确实需要获取完整响应头、状态码等信息，要保留observe: 'response'，则调整返回类型：

public customGetForDownload(params: any): Observable<HttpResponse<Blob>> {
    // 其余配置不变，增加observe配置
    return this.httpClient.get(absoluteUrl, {
      headers: headers,
      params: httpParams,
      responseType: 'blob',
      observe: 'response'
    });
}

2. Component.ts错误点修正

• 不需要重复创建Blob对象，接口返回的已经是标准Blob格式
• 重复调用window.open和a.click无意义，且可能触发浏览器弹窗拦截
• 用完的对象URL需要手动释放，避免内存泄漏

如果Service直接返回Blob：

this.Service.customGetForDownload(this.params).subscribe(
  (data: Blob) => {
    const fileURL = URL.createObjectURL(data);
    const a = document.createElement('a');
    a.href = fileURL;
    a.download = 'reports.pdf';
    document.body.appendChild(a);
    a.click();
    // 清理资源
    document.body.removeChild(a);
    URL.revokeObjectURL(fileURL);
  },
  (error) => {
    console.log('getPDF error: ', error);
  }
);

如果Service返回的是HttpResponse对象，就取data.body作为Blob数据源即可。

第二步：后端逻辑排查 #

如果前端修正后还是无法打开PDF，按以下步骤排查后端：

• 用Postman直接调用PDF导出接口，将返回内容保存为PDF文件，尝试打开。如果打不开，说明是后端生成逻辑问题
• 检查后端generateReportDocument方法是否正常生成PDF：可以先把生成的ByteArrayInputStream写入本地磁盘，验证文件本身是否正常
• 排查是否有全局异常拦截器吞了生成PDF时的报错，返回了JSON格式的错误信息，导致前端把错误信息当PDF保存：可以用记事本打开下载的损坏PDF，如果开头不是%PDF-，说明返回的内容不是PDF二进制流，大概率是JSON错误串
• 不需要手动配置Content-Length，Spring会自动处理InputStreamResource的流传输和关闭

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