Sphinx 上的 Graphviz 在 Alpine 上运行时会生成非常高的图表

Question

在 Sphinx 上使用扩展

sphinx.ext.graphviz

，在 CI 上执行 Sphinx 时，生成的图形非常高（×3700 预期高度）。

问题出在生成的图像上，通过检查生成的 SVG 可以看出：

本地生成：

<svg width="424pt" height="1029pt"
 viewBox="0.00 0.00 423.88 1029.00"

CI 生成：

<svg width="505pt" height="3822670pt"
 viewBox="0.00 0.00 505.23 3822669.58"

更改 Graphviz 版本、Sphinx 版本，甚至基础镜像版本都没有帮助。

Answer 1

问题出在 Alpine。我没有找到任何具体提及 GraphViz 在 Alpine 上的这种行为，但是 Python 的官方图像页面 在 Alpine 上提供了这个：

需要注意的主要警告是它确实使用 musl libc 而不是 glibc 和朋友，因此软件经常会遇到问题，具体取决于其 libc 要求/假设的深度。

将基础镜像更改为 Debian (

python:3.12-bullseye

) 解决了问题。