服务器端DOMpdf运行异常：stream()函数参数不足报错排查

核心原因：两种安装方式的版本与生态差异 #

你本地用Composer从Git安装的是DOMPDF官方维护的标准版本，而服务器通过apt install php-dompdf安装的是Debian/Ubuntu打包的系统定制版，二者在目录结构、初始化逻辑、API规范上完全不同：

• 官方版本依赖Composer的自动加载机制，通过vendor/autoload.php初始化，采用现代PHP命名空间（如Dompdf\Dompdf），API参数有合理默认值；
• 系统包版本是旧版分支，无autoload机制，依赖传统的dompdf_config.inc.php初始化，API要求更严格（比如DOMPDF::stream()必须传至少1个参数），且目录结构和官方版本不兼容。

具体报错对应问题 #

1. 500内部服务器错误：最初的require路径错误，找不到正确的DOMPDF初始化文件，导致核心类未定义；
2. DOMPDF::stream()参数错误：系统包版本的该方法强制要求传入输出文件名参数，而你本地代码可能用了官方新版本的写法（允许省略参数），二者不兼容。

解决办法 #

方案一：用Composer在服务器安装官方版本（推荐，和本地环境一致） #

1. 服务器安装Composer（未安装的话）：

   php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" && php composer-setup.php && php -r "unlink('composer-setup.php');"
   

2. 进入项目目录，执行命令安装DOMPDF：

   composer require dompdf/dompdf
   

3. 代码保留本地的标准写法：

   require 'vendor/autoload.php';
   use Dompdf\Dompdf;
   
   $dompdf = new Dompdf();
   $dompdf->loadHtml('<h1>测试内容</h1>');
   $dompdf->render();
   $dompdf->stream('output.pdf'); // 传入文件名，兼容所有版本
   

方案二：适配系统包版本的php-dompdf #

1. 确认正确的初始化文件路径：系统包的核心文件通常在/usr/share/php/dompdf/dompdf_config.inc.php，而非/etc/php-dompdf/（后者是配置目录）；
2. 修改代码适配旧版API：

   require_once '/usr/share/php/dompdf/dompdf_config.inc.php';
   
   $dompdf = new DOMPDF();
   $dompdf->load_html('<h1>测试内容</h1>');
   $dompdf->render();
   $dompdf->stream('output.pdf'); // 必须传入文件名参数
   

3. 检查权限：确保web服务器用户（如www-data）拥有dompdf目录及文件的读取权限。

内容的提问来源于stack exchange，提问作者Simon King