WeasyPrint SVG渲染崩溃问题分析与修复

在WeasyPrint项目中，近期版本（60.1之后）出现了一个涉及SVG图表渲染的关键问题。该问题会导致包含特定标签结构的SVG文件在渲染时触发断言错误，影响从Highcharts和Plotly等主流图表库生成的SVG内容。

问题现象

当用户尝试渲染包含复杂路径和文本标签的SVG图表时，系统会在PDF生成阶段抛出异常。核心错误表现为：

assert self._ctm_stack

这个断言失败发生在PDF流处理模块的pop_state方法中，表明图形状态堆栈出现了不匹配的情况。

技术背景

SVG作为矢量图形标准，在Web图表可视化领域应用广泛。现代图表库（如Highcharts/Plotly）生成的SVG通常包含以下特征：

1. 多层嵌套的<g>分组元素
2. 复杂的路径定义（贝塞尔曲线等）
3. 精确的文本定位和样式控制
4. 裁剪路径等高级特性

WeasyPrint的SVG处理引擎需要正确维护图形状态（包括当前变换矩阵CTM），这对保证渲染准确性至关重要。

问题根源

通过分析用户提供的测试案例，我们发现：

1. 当SVG中包含特定顺序的<clipPath>定义和实际使用时会破坏CTM堆栈平衡
2. 文本标签的精确变换计算与图形状态管理存在时序问题
3. 某些路径绘制操作未能正确维护状态机

解决方案

项目维护团队迅速响应并提交了修复方案：

1. 加强CTM堆栈的状态检查
2. 优化SVG元素处理流程的状态管理
3. 确保图形操作与状态变化严格同步

用户建议

对于遇到类似问题的开发者：

1. 临时解决方案可回退到60.1稳定版本
2. 更新到包含修复的最新版本
3. 检查SVG中是否包含非常规的裁剪路径组合
4. 简化复杂图表的层级结构可能提高兼容性

该修复已通过用户验证，确认解决了Plotly等库生成的SVG图表渲染问题。这体现了WeasyPrint项目对标准兼容性和稳定性的持续改进。