Yii2框架下Kartik MPDF无提示终止生成PDF问题求助

问题描述 #

我正在开发基于Yii2框架的项目，其中包含用户数据导出为PDF的功能，使用kartik-v/yii2-mpdf组件（版本为dev-master）。该PDF包含样式、表格、文本及图片，业务逻辑为先生成100个页面再合并为单个PDF。通过CRON任务执行时，程序无警告、错误或异常提示就终止运行，最终生成0字节大小的PDF。已尝试通过以下代码覆盖内存限制和最大执行时间：

ini_set('memory_limit', -1);
ini_set('max_execution_time', 0);
set_time_limit(0);

但问题仍未解决。

排查方向与解决方法 #

1. 修正CRON环境的PHP配置差异 #

CRON执行环境的PHP配置通常和Web环境独立，代码中的ini_set可能无法覆盖系统级限制：

• 直接修改CLI模式的PHP配置文件（如php-cli.ini），设置memory_limit = -1、max_execution_time = 0
• 在CRON命令中显式指定配置文件，示例：

  php -c /etc/php/8.1/cli/php.ini /path/to/your/yii/console/command.php
  

2. 开启全量日志追踪隐性错误 #

CRON执行无终端输出，必须主动记录日志定位问题：

• 在PDF生成的关键节点添加日志：

  Yii::info('开始生成第'.$pageNum.'个PDF页面', 'pdf_export');
  // 页面生成逻辑
  Yii::info('第'.$pageNum.'个PDF页面生成完成，临时文件路径：'.$tempPath, 'pdf_export');
  

• 捕获致命错误与异常并写入日志：

  register_shutdown_function(function() {
      $error = error_get_last();
      if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
          Yii::error('致命错误: ' . $error['message'] . ' 文件: ' . $error['file'] . ' 行号: ' . $error['line'], 'pdf_export');
      }
  });
  
  try {
      // PDF生成与合并逻辑
  } catch (\Exception $e) {
      Yii::error('异常: ' . $e->getMessage() . ' 追踪栈: ' . $e->getTraceAsString(), 'pdf_export');
  } catch (\Throwable $e) {
      Yii::error('Throwable错误: ' . $e->getMessage() . ' 追踪栈: ' . $e->getTraceAsString(), 'pdf_export');
  }
  

3. 优化PDF生成的内存占用 #

100页PDF合并易触发内存溢出，即使设置memory_limit=-1也可能因系统物理内存不足被终止：

• 改用逐页追加模式：先生成基础PDF对象，循环将每个页面直接追加到该对象中，避免生成100个独立PDF再合并
• 压缩图片资源：将PDF引用的图片压缩至72DPI（屏幕分辨率），降低内存占用
• 及时清理临时文件：生成单页PDF后，若无需保留则立即删除临时文件，释放磁盘与内存空间

4. 切换组件稳定版本 #

dev-master版本可能存在未修复的BUG：

• 修改composer.json的版本约束为稳定版，例如kartik-v/yii2-mpdf: ^1.0，执行composer update kartik-v/yii2-mpdf更新
• 排查组件GitHub Issues，确认是否存在CRON环境下的0字节PDF生成问题

5. 验证CRON执行权限与路径 #

• 确保CRON执行用户拥有PDF保存目录的读写权限，可通过chown或chmod调整目录权限
• 代码中引用的图片、样式文件必须使用绝对路径，CRON的工作目录与Web环境不同，相对路径会导致资源加载失败

内容的提问来源于stack exchange，提问作者Paresh Maheshwari