You need to enable JavaScript to run this app. Laravel应用中使用Vue.js与Axios获取PDF耗时近2分钟,如何优化请求速度
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.31 18:45:04