Imagick转换SVG无内容问题排查求助

问题概述 #

某次更新后，运行多年的PHP Imagick SVG转PNG脚本出现异常：

• 转换签名SVG时，生成的PNG尺寸正确，但无签名内容
• 测试矩形SVG可正常生成对应图像
• 测试含path的线条SVG时，仅生成符合尺寸的空白图像
  已精简代码测试调试，问题仍未解决，需排查原因并给出解决办法。

原测试代码 #

$svg = <<<SVG
<?xml version="1.0" encoding="UTF-8" standalone="no"?><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" width="76" height="130"><path fill="none" stroke="#000000" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" d="M 1 120 c 0.05 -0.14 1.61 -5.62 3 -8 c 3.16 -5.42 6.98 -10.7 11 -16 c 10.03 -13.21 20.14 -24.67 30 -38 c 8.64 -11.69 16.71 -23.19 24 -35 c 2.23 -3.62 3.67 -8 5 -12 c 0.62 -1.87 1.6 -4.79 1 -6 c -0.72 -1.43 -4.28 -4 -6 -4 c -2.34 0 -6.67 2.11 -9 4 c -4.19 3.39 -8.58 8.38 -12 13 c -3.12 4.21 -5.87 9.31 -8 14 c -1.09 2.4 -1.62 5.37 -2 8 c -0.27 1.92 -0.31 4.14 0 6 c 0.33 1.96 0.93 4.4 2 6 c 2.04 3.05 6.19 5.92 8 9 c 1.24 2.11 1.78 5.35 2 8 c 0.43 5.15 0.42 10.66 0 16 c -0.59 7.41 -1.24 14.97 -3 22 c -1.85 7.41 -8 22 -8 22"/></svg>
SVG;

$image = new Imagick();

$image->readImageBlob($svg);

$image->setImageFormat("png");

$canvas = new Imagick();
$canvas->newImage($image->getImageWidth(), $image->getImageHeight(), 'white');
$canvas->setImageFormat('png');

$canvas->compositeImage($image, Imagick::COMPOSITE_OVER, 0, 0);

$filePath = $folder.'/test.png'; // 替换为实际保存路径
$canvas->writeImage($filePath);

// 清理资源
$image->clear();
$canvas->clear();
$image->destroy();
$canvas->destroy();

调试测试结果 #

1. 矩形SVG测试正常生成图像：

$svg = <<<SVG
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<svg width="100" height="100" xmlns="http://www.w3.org/2000/svg">
    <rect x="10" y="10" width="80" height="80" fill="black" />
</svg>
SVG;

2. 含path的线条SVG测试仍生成空白图像：

$svg = <<<SVG
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<svg xmlns="http://www.w3.org/2000/svg" version="1.1" width="200" height="100">
    <path fill="none" stroke="#000000" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" d="M 10 50 L 190 50"/>
</svg>
SVG;

故障原因分析 #

1. 渲染引擎兼容性问题：Imagick依赖的Ghostscript或RSVG库更新后，对SVG中fill="none"的path元素、stroke相关属性（如stroke-linecap、stroke-linejoin）的解析逻辑发生变化，导致线条无法渲染。
2. SVG声明兼容性：原SVG中的DTD引用（<!DOCTYPE svg...>）在新版本库中可能触发解析错误，或命名空间/版本声明的处理逻辑改变。
3. Imagick配置变更：更新后Imagick默认的SVG渲染引擎被切换，新引擎对部分SVG特性支持不完善。

解决办法 #

1. 强制指定SVG渲染引擎 #

在读取SVG前，强制Imagick使用RSVG引擎（对SVG特性支持更完善）：

$image = new Imagick();
// 强制使用RSVG渲染SVG
$image->setOption('svg:engine', 'rsvg');
$image->readImageBlob($svg);

2. 简化SVG声明与属性 #

• 移除SVG中的DTD引用，避免旧版DTD与新渲染引擎冲突：直接删除原SVG开头的<!DOCTYPE svg...>内容。
• 暂时移除stroke-linecap、stroke-linejoin等属性，测试是否能正常渲染线条，再逐步添加排查问题属性。

3. 调整SVG的fill属性 #

将fill="none"替换为fill="transparent"，部分渲染引擎对transparent的处理更友好：

<path fill="transparent" stroke="#000000" stroke-width="2" ... />

4. 检查并调整依赖库版本 #

• 若为Ghostscript更新导致问题，可降级到之前稳定版本；或升级到最新版修复已知bug。
• 确保RSVG库版本与Imagick兼容，必要时重新编译Imagick关联最新RSVG。

5. 直接输出SVG转换结果排查 #

先跳过画布合成步骤，直接输出SVG转换后的PNG，确认是否是合成环节问题：

$image = new Imagick();
$image->readImageBlob($svg);
$image->setImageFormat("png");
$image->writeImage('test_raw.png'); // 直接输出SVG转换后的图像

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