Yii本身不解析PDF，“超时”实为集成的第三方组件（如MPDF、TCPDF或PDF-Parser-1.0）在处理加密、扫描件、高分辨率图像、文件损坏等异常PDF时卡住；需检查文件完整性、优化组件配置、提升PHP执行限制，并优先用pdftotext等轻量工具提取文本。
Yii 框架本身不直接解析 PDF，所谓“Yii 解析 PDF 超时”，实际是指在 Yii 项目中集成的第三方 PDF 处理组件（如 MPDF、tcpdf、setasign/fpdi 或调用外部服务如 PDF-Parser-1.0）在读取、渲染或提取内容时卡住、响应缓慢甚至中断。超时通常不是 Yii 的问题，而是底层 PDF 处理环节受阻。
检查 PDF 文件是否含阻碍性特征
很多超时源于 PDF 本身结构复杂或受限：
- 文件被密码加密（即使仅限打开权限），MPDF/tcPDF 等库默认无法自动处理，会卡在解密阶段；
- 嵌入大量高分辨率图像、字体子集或使用 PDF 2.0 新特性（如对象流压缩、JBIG2 编码），旧版解析库不兼容；
- 文档是扫描件（纯图像型 PDF），而你未启用 OCR 步骤，程序试图“读文字”却找不到任何文本流，长时间等待后超时；
- 文件头损坏或末尾截断（如下载不完整），导致解析器反复校验失败，陷入重试循环。
建议先用系统自带预览或 Adobe Acrobat 打开确认能否正常加载第一页；再用命令行快速验证文件头：head -c 4 your.pdf 应输出 %PDF。
优化 MPDF/tcPDF 的初始化与加载逻辑
若使用 MPDF 生成或读取 PDF（如通过 FPDI 导入模板），常见超时点在 new \Mpdf\Mpdf() 或 $pdf->Output() 阶段：
- 避免在每次请求中重复创建 MPDF 实例，可考虑复用或延迟初始化；
- 禁用非必要功能：设置
'mode' => 'utf-8'、'format' => 'A4'明确参数，关闭'debug' => false和'tempDir'指向可写且空间充足的路径； - 若加载外部 CSS，务必用 绝对文件系统路径（非 Web URL），否则 MPDF 会因无法读取样式而阻塞或静默失败；
- 对大文档分页处理，不要一次性 WriteHTML 整个长 HTML，改用
WriteHTML($pageHtml, 2)分段写入。
排查服务级与环境瓶颈
超时也常来自运行环境限制，而非代码逻辑：
- PHP 执行时间不足：检查
max_execution_time（建议设为 120+ 秒），并确认未被 .htaccess 或 Nginx fastcgi_read_timeout 覆盖； - 内存耗尽：PDF 渲染尤其吃内存，80 页含图文档可能需 256MB+；在
php.ini中调高memory_limit（如512M）； - 临时目录不可写或磁盘满：MPDF 默认使用系统 tmp，可通过
'tempDir' => '@runtime/mpdf'指向 Yii 的 runtime 目录，并确保该路径存在且有写权限； - GD/Imagick 扩展缺失：若 PDF 含 PNG/JPEG 图像或需缩略图，缺少图像扩展会导致解析挂起，运行
php -m | grep -i gd确认。
绕过解析，改用轻量提取方案
如果目标只是“读取文字内容”而非渲染 PDF，强行用 MPDF 解析是低效且易超时的。更合理的方式是：
- 用命令行工具预处理：在服务器安装
pdftotext（Poppler 工具集），执行exec("pdftotext -layout '$pdfPath' -", $output)获取纯文本，速度快、容错高； - 对扫描件 PDF，搭配 Tesseract OCR：先用
pdfimages -list file.pdf提取所有图层，再逐张调用tesseract识别； - 在 Yii 中封装为独立命令行任务（如通过 yii command 或 Supervisor 后台运行），避免 Web 请求超时限制。
