TCPDF加载PHP生成的QR码时遇间歇性错误及本地路径调用失败

问题根源分析 #

先把两个核心问题的本质说清楚：

1. 本地路径加载phpqrcode.php完全失败：TCPDF的Image()方法遇到本地文件路径时，会直接调用imagecreatefrompng()读取文件内容——但phpqrcode.php是PHP脚本，本身不是PNG图片，所以必然报错。只有通过Web服务器的HTTP请求访问时，服务器才会执行这个脚本并输出PNG数据流，本地文件系统只会读取脚本源代码，完全不是一回事。
2. HTTP路径加载间歇性失效：大概率和这些因素有关：
   • TCPDF内部的HTTP请求超时设置过短，服务器负载高时phpqrcode生成二维码的响应慢，导致请求超时失败
   • phpqrcode生成过程中偶尔出现内存不足、GD库资源竞争等问题，导致输出异常
   • 没有缓存生成的二维码，重复请求时服务器压力大，偶尔处理不过来

最优解决方案：直接本地生成二维码传入TCPDF #

最可靠的方式是直接调用phpqrcode的API生成二维码内容，绕开HTTP请求和本地文件加载的坑，这样既解决了本地路径的问题，也消除了HTTP请求的不稳定因素。

方案1：生成临时PNG文件后加载

这种方式直观，适合需要保留二维码文件的场景：

// 1. 引入phpqrcode（确保路径正确）
require_once __DIR__ . '/../../path/includes/php/phpqrcode.php';

// 2. 生成唯一临时文件路径
$tempQrPath = sys_get_temp_dir() . '/temp_qr_' . uniqid() . '.png';

// 3. 调用phpqrcode生成二维码到临时文件
QRcode::png($random, $tempQrPath, QR_ECLEVEL_L, 4);

// 4. 让TCPDF加载这个合法的PNG文件
$pdf->Image($tempQrPath, 12, 250, 20, 20, 'PNG', '', '', true, 150, '', false, false, 0, false, false, false);

// 5. 用完后删除临时文件（可选，也可以保留做短时间缓存）
unlink($tempQrPath);

方案2：直接生成内存数据流（无需临时文件）

如果不想生成临时文件，可以捕获phpqrcode的输出，转成TCPDF能识别的数据流：

require_once __DIR__ . '/../../path/includes/php/phpqrcode.php';

// 1. 开启输出缓冲，捕获phpqrcode的PNG输出
ob_start();
QRcode::png($random, null, QR_ECLEVEL_L, 4);
$qrData = ob_get_contents();
ob_end_clean();

// 2. 用@前缀将数据流传给TCPDF的Image方法
$pdf->Image('@' . $qrData, 12, 250, 20, 20, 'PNG', '', '', true, 150, '', false, false, 0, false, false, false);

小提示：TCPDF的Image()方法支持以@前缀传入原始图像数据流，完全绕开文件系统和HTTP请求，效率更高。

（可选）修复HTTP方式的间歇性问题 #

如果坚持要使用HTTP路径加载，可尝试以下优化：

• 调整TCPDF超时：找到TCPDF配置文件中的TCPDF_HTTP_TIMEOUT参数，把默认的3秒延长到10秒左右
• 添加缓存机制：对生成的二维码按$random值做缓存，避免重复请求phpqrcode生成
• 增强错误处理：在phpqrcode的脚本里加try-catch，确保异常时能输出有效信息，方便排查

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