Laravel dompdf返回200状态码但点击按钮无法下载PDF如何解决

核心问题原因 #

这个问题基本不是后端dompdf生成逻辑的错误，核心是前端发起请求的方式不对：如果你用axios、fetch、$.ajax这类异步方式请求下载接口，浏览器默认不会自动处理二进制流响应触发下载，哪怕后端返回正常、状态码200，PDF内容只会存在异步请求的响应体里，不会弹出下载提示。 #

修复方案 #

方案1：改用非异步方式触发（最简单，优先推荐） #

不需要写复杂的JS逻辑，直接用原生浏览器跳转/表单提交触发请求即可：

• 简单GET场景直接用a标签：

<a href="/你的PDF生成路由地址?download=1" class="btn">下载日报PDF</a>

• 需要POST传参/带CSRF校验的场景，用原生form表单提交，不要加异步提交的监听：

<form action="/你的PDF生成路由地址" method="POST">
    @csrf
    <input type="hidden" name="download" value="1">
    <!-- 其他业务参数 -->
    <button type="submit" class="btn">下载日报PDF</button>
</form>

方案2：必须用异步请求时，前端手动处理二进制流触发下载 #

如果业务场景必须用异步请求（比如需要先做权限校验、带特殊请求头），需要手动指定响应类型为二进制流，收到响应后生成临时地址触发下载，以axios为例：

axios.post('/你的PDF生成路由地址', {
    download: 1,
    // 其他业务参数
}, {
    responseType: 'blob' // 必填，指定接收二进制Blob对象
}).then(res => {
    // 解析文件名，也可以直接写死为summarydaily.pdf
    const disposition = res.headers['content-disposition']
    let fileName = 'summarydaily.pdf'
    if (disposition) {
        const matchRes = disposition.match(/filename[^;=\n]*=((['"]).*?\2|[^;\n]*)/)
        if (matchRes?.[1]) fileName = matchRes[1].replaceAll(/['"]/g, '')
    }
    // 创建临时下载链接
    const blob = new Blob([res.data], { type: 'application/pdf' })
    const tempUrl = window.URL.createObjectURL(blob)
    const link = document.createElement('a')
    link.href = tempUrl
    link.download = fileName
    document.body.appendChild(link)
    link.click()
    // 清理临时DOM和内存占用
    document.body.removeChild(link)
    window.URL.revokeObjectURL(tempUrl)
})

后端排查注意点 #

• 检查下载路由是否被全局响应格式化中间件拦截：如果你的项目有全局中间件把所有响应包装成{code:200, data:xxx, msg:"success"}的JSON结构，要把PDF路由加入排除列表，确保返回的是纯PDF响应对象，没有额外JSON包装。
• 可以给响应补充缓存控制头，避免部分浏览器因为缓存策略异常不识别下载响应，调整后端代码如下：

$pdf = Pdf::loadView('pdf.summary-daily', ['lastData' => $lastData, 'today' => $today]);

if ($request->download) {
    return $pdf->download('summarydaily.pdf')
        ->header('Cache-Control', 'no-cache, must-revalidate');
}
return $pdf->stream('summarydaily.pdf');

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