Laravel应用中使用Vue.js与Axios获取PDF耗时近2分钟,如何优化请求速度
Laravel+Vue下载PDF速度过慢的优化方案
耗时接近2分钟的场景,基本是后端PDF生成、数据库查询环节占了绝大多数时间,前端的额外开销占比非常小,可以按照从后端核心流程到前端、再到配套配置的顺序逐项优化:
一、后端核心流程优化
- 先修复基础代码bug
原控制器中PDF文件名的字符串写法存在语法问题:->stream("'Faktura nr.' $id '.pdf'")多余的嵌套单引号会增加PHP字符串解析的额外开销,还会导致下载的文件名带上多余的引号,直接修正为正确的字符串拼接即可。 - 消除冗余数据库查询与N+1问题
原控制器三次独立查询数据的写法完全可以合并优化:Auth::user()是Laravel路由中间件已经完成解析的对象,不需要重复发起数据库查询获取当前用户信息- Invoice、User、Company三张表存在外键关联的话,直接用预加载语法
Invoice::with(['明细关联项', 'user.company'])->find($id)一次性查完所有需要的数据,避免视图渲染时因为没加载关联触发额外的SQL查询,减少无效的数据库交互耗时 - 给查询用到的
id、companies_id等字段加合适的数据库索引,避免大表下全表扫描拖慢查询速度
- 优化PDF生成引擎配置
如果用的是dompdf类的PHP PDF生成库,生产环境一定要关闭debug调试模式;不需要远程资源的话关闭远程加载开关,开启字体子集化压缩,减少渲染时的资源加载和最终PDF的文件体积。如果PDF里带图片资源,不要每次渲染都从网络拉取,提前把图片缓存到本地服务器路径,避免每次生成都走网络请求等待图片加载。 - 增加生成结果的本地缓存,避免重复渲染
同一个发票ID对应的PDF,只要发票、用户、公司信息没有修改,生成的内容完全固定。可以把第一次渲染好的PDF文件直接存在本地存储目录,下次请求时先检查对应文件是否存在:- 文件已存在的话直接返回文件流,不需要再走查库、渲染PDF的流程
- 只有当对应的发票信息更新时,再删除缓存的PDF文件,下次请求重新生成
这种方式可以让第一次生成后的后续请求耗时从分钟级降到毫秒级,核心逻辑参考:
public function download($id) { $pdfFileName = "Faktura nr. {$id}.pdf"; $pdfSavePath = storage_path("app/invoices/{$id}.pdf"); // 已缓存的PDF直接返回 if (file_exists($pdfSavePath)) { return response()->file($pdfSavePath, [ 'Content-Disposition' => "attachment; filename=\"{$pdfFileName}\"" ]); } // 首次生成的逻辑 $invoice = Invoice::with(['items', 'user.company'])->findOrFail($id); return PDF::loadView('app.pdf.invoice', compact('invoice')) ->save($pdfSavePath) // 生成时直接存本地,下次复用 ->download($pdfFileName); }
二、前端流程优化
- 修正无效的代码属性bug
原前端代码里给a标签赋值link.stream = '文件名'是完全无效的DOM属性,浏览器识别不到,正确的下载文件名属性是link.download。这个bug会导致浏览器下载时反复探测文件类型,增加不必要的等待开销。 - 砍掉不必要的Axios二进制中转流程
纯文件下载场景完全不需要用Axios把PDF文件先读成arraybuffer存在浏览器内存、再手动生成blob链接的流程:
这种方式会多两次数据拷贝(网络层→Axios内存→Blob对象),文件体积越大,内存解析的耗时越高。可以直接把a标签的href指向后端下载接口,加上download属性让浏览器原生处理下载流程,省掉JS层的全部中转开销。如果不需要带自定义鉴权头,原生下载的速度会比Axios中转快30%以上。
三、配套服务器优化
- 检查PHP-FPM的进程数配置,PDF生成是CPU密集型操作,进程数不足会导致请求排队等待,是常见的请求等待几十秒的原因
- 给接口开启gzip压缩,减少PDF文件的网络传输体积,弱网环境下的传输耗时会明显下降
- 如果首次生成的耗时确实很长,可以把PDF生成逻辑改造成异步队列任务:用户点击下载时接口立即返回受理状态,后台队列慢慢生成PDF,完成后再通知用户下载,把用户的等待时间从分钟级降到百毫秒级。
内容的提问来源于stack exchange,提问作者Boendergaard
相关产品推荐
相关产品推荐

