DOMPDF生成PDF输出到浏览器时Firefox无法识别仅提示下载如何解决

核心原因 #

• Dompdf的stream()方法参数使用错误
  stream()方法的第一个参数是生成的PDF文件名，而非$dompdf->output()返回的PDF二进制内容。你错误传入了PDF二进制数据作为文件名，会导致响应头中的Content-Disposition字段异常，Chromium内核浏览器（Chrome、Edge、Opera）对异常响应头的容错率较高，依然可以识别为可预览的PDF，而Firefox对响应头格式校验更严格，会直接判定为需要下载的文件，触发打开/保存提示。
• 缺少显式MIME类型声明
  部分环境下dompdf自动生成的Content-Type: application/pdf头可能因为服务器配置、输出缓冲污染丢失，Firefox识别不到正确的PDF MIME类型就不会触发内置预览。

修复后的代码 #

<?php
    ob_start();

    $id = $_GET['id'];

    require "./mypage.php"; 
    $html = ob_get_clean();

    // include autoloader
    require_once './dompdf/autoload.inc.php';

    //Reference of Dompdf namespace
    use Dompdf\Dompdf;
    use Dompdf\Options;
    
    // instantiate and use the dompdf class
    $options = new Options();
    $options->set('enable_html5_parser', true);
    $options->set('isJavascriptEnabled', true);

    $dompdf = new Dompdf($options);

    //Create PDF
    $dompdf->loadHtml($html);

    // Render the HTML as PDF
    $dompdf->render();

    // 移除多余的$output获取步骤，stream方法会自行处理输出
    // 第一个参数传自定义的PDF文件名即可，Attachment设为false表示 inline 预览
    $dompdf->stream("预览文件.pdf", array("Attachment" => false));
    exit(0);
?>

额外排查点 #

如果修改后问题仍然存在，可按以下顺序排查：

• 检查当前PHP文件的开头、结尾是否有多余的空格、换行，或者代码中是否有提前输出的内容（比如调试用的echo、var_dump，或是PHP报错信息），这些内容会破坏响应头结构，导致Firefox无法识别PDF格式
• 在调用stream()方法前手动添加响应头：header('Content-Type: application/pdf'); 强制指定MIME类型
• 检查Firefox本地配置：进入浏览器设置→常规→应用程序，找到PDF格式的默认处理方式，确认设置为「在Firefox中预览」

内容的提问来源于stack exchange，提问作者Ale MaDaMa