PHP中GD库无法正常工作，仅显示黑色方块求助

看起来你遇到的是GD库加载图片失败导致的输出异常，虽然日志没报错，但我们可以一步步排查定位问题：

1. 确保图片文件能被PHP正确读取 #

这是最常见的诱因，哪怕图片和脚本在同一目录，也可能存在以下问题：

• 文件权限问题：确保test.jpg的权限允许web服务器用户（比如www-data）读取，你可以执行以下命令调整：

  chmod 644 test.jpg
  chown www-data:www-data test.jpg
  

• 路径匹配问题：PHP的工作目录可能不是脚本所在目录，建议改用绝对路径加载图片，替换代码中的路径部分：

  $im = imagecreatefromjpeg(__DIR__ . '/test.jpg');
  

• 图片本身损坏：确认test.jpg是有效的JPEG文件，可通过系统命令验证：

  file test.jpg
  

  正常输出应包含JPEG image data字样。

2. 检查GD库的JPEG格式支持 #

虽然你提到服务器已启用GD库，但可能缺少JPEG格式的支持。可以创建一个phpinfo页面查看细节：

<?php phpinfo(); ?>

在输出的GD模块部分，确认是否有JPEG Support => enabled这一项。如果没有，在Debian上安装对应依赖包：

apt-get install php7.2-gd libjpeg62-turbo-dev

安装完成后重启web服务器（比如systemctl restart apache2或nginx）。

3. 添加错误检测代码 #

你的代码没有对图片加载结果做判断，当imagecreatefromjpeg失败时会返回false，后续操作都会基于无效资源执行，最终输出黑色方块。建议添加错误检测逻辑：

<?php 
error_reporting(E_ALL);
ini_set('display_errors', 1); // 临时开启错误显示，方便排查
header("Content-type: image/png");
$string = $_GET['text'] ?? 'Default Text'; // 处理text参数为空的情况

$im = imagecreatefromjpeg(__DIR__ . '/test.jpg');
if (!$im) {
    die('Failed to load image file'); // 加载失败时直接返回明确提示
}

$orange = imagecolorallocate($im, 220, 210, 60);
$px = (imagesx($im) - 7.5 * strlen($string)) / 2;
imagestring($im, 3, $px, 9, $string, $orange);
imagepng($im);
imagedestroy($im); 
?>

这样如果加载失败，你会看到明确的错误提示，而非黑色方块。

4. 检查输出前的多余内容 #

确保脚本的<?php标签前没有任何空格、换行或BOM头，这些内容会导致header()无法正确发送，浏览器无法识别图片类型，从而显示黑色方块。你可以用纯文本编辑器打开脚本，确认开头没有多余字符。

内容的提问来源于stack exchange，提问作者Ben S.