Docker容器内Graphviz导出SVG坐标异常问题排查求助

问题描述 #

我正在使用Graphviz渲染图形，应用部署在基于php:8.1-fpm-alpine3.20的Docker容器中。在容器内执行命令dot -Tsvg -Gsize=10,10\! -Gscale=1 -Eminlen=1 graph.dot -o output.svg时，生成的SVG文件节点坐标完全错误；但在本地macOS环境执行相同命令，能得到正常可用的SVG。

奇怪的是，当graph.dot中仅保留两个节点时，容器内和本地环境都能正常生成SVG。

环境配置（Dockerfile） #

# setup timezones properly
FROM alpine:3.17.0 AS timezone

RUN apk add tzdata

FROM php:8.1-fpm-alpine3.20 as prod

ARG HOST_USER_ID
ARG HOST_GROUP_ID
ARG TIMEZONE

ARG DEBIAN_FRONTEND=noninteractive
ARG DEV_DEPS="libzip-dev libxml2-dev"

RUN echo "http://dl-cdn.alpinelinux.org/alpine/edge/main" >> /etc/apk/repositories && \
    echo "http://dl-cdn.alpinelinux.org/alpine/edge/community" >> /etc/apk/repositories && \
    echo "http://dl-cdn.alpinelinux.org/alpine/edge/testing" >> /etc/apk/repositories && \
    apk update

COPY --from=timezone /usr/share/zoneinfo/${TIMEZONE} /etc/localtime

RUN set -xe && \
    echo "${TIMEZONE}" > /etc/timezone && \
    apk add --no-cache --update zlib libzip git openssh-client pcre-dev gmp-dev postgresql-dev libpq && \
    apk add --no-cache --update --virtual .phpize-deps ${PHPIZE_DEPS} && \
    apk add --no-cache --update --virtual .dev-deps ${DEV_DEPS} && \
    apk add ttf-dejavu && \
    apk add --no-cache --update graphviz>=11.0.0-r0 --repository="https://dl-cdn.alpinelinux.org/alpine/edge/community" && \
    # create app user
    addgroup -S -g ${HOST_GROUP_ID} app && \
    adduser -S -s /bin/sh -DS -u ${HOST_USER_ID} -G app app  && \
    # download and install composer
    php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" && \
    php composer-setup.php --install-dir=/usr/bin --filename=composer --2 && \
    php -r "unlink('composer-setup.php');" && \
    # update pecl extensions
    pecl channel-update pecl.php.net && \
    # install core extensions
    docker-php-ext-install pdo_pgsql pgsql zip xml opcache pcntl gmp sockets && \
    # cleanup
    apk del --purge .phpize-deps .dev-deps && \
    rm -rf /tmp/* && \
    rm -rf /usr/share/php8 && \
    rm -rf /var/cache/apk/*

FROM prod as dev

RUN set -xe && \
    apk add --no-cache --update zlib libzip git openssh-client pcre-dev linux-headers && \
    apk add --no-cache --update --virtual .phpize-deps ${PHPIZE_DEPS} && \
    apk add --no-cache --update --virtual .dev-deps ${DEV_DEPS} && \
    # install extension via pecl
    pecl install xdebug && \
    # enable extensions installed via pecl
    docker-php-ext-enable xdebug && \
    # cleanup
    apk del --purge .phpize-deps .dev-deps && \
    rm -rf /tmp/* && \
    rm -rf /usr/share/php8 && \
    rm -rf /var/cache/apk/*

测试用Graphviz文件 #

有问题的多节点版本 #

digraph Workflow {
  rankdir=TB;

  ValidateDescription [ label=ValidateDescription, style=filled, fillcolor=green, color=black ];
  SendEmail [ label=SendEmail, style=filled, fillcolor=red ];
  end [ label=end, style=filled, fillcolor=red ];
  ValidateDescription -> SendEmail [ label=pass, color=darkgreen ];
  ValidateDescription -> end [ label=fail, color=red ];
  SendEmail -> end [ label=success, color=darkgreen ];
  SendEmail -> end [ label=fail, color=red ];
} /* /digraph Workflow */

正常的两节点版本 #

digraph Workflow {
  rankdir=TB;

  ValidateDescription [ label=ValidateDescription, style=filled, fillcolor=green, color=black ];
  SendEmail [ label=SendEmail, style=filled, fillcolor=red ];
} /* /digraph Workflow */

原因分析与调试修复方案 #

可能原因 #

1. Graphviz版本差异：容器中安装的是11.0.0+版本，而本地macOS可能使用旧版本。Graphviz 10+默认启用了新的dot2布局算法，替代了传统dot，新算法在坐标计算逻辑上有变化，再加上你指定的size和scale参数在新版本中的行为不一致，导致布局异常。
2. 字体环境差异：虽然容器内安装了ttf-dejavu，但musl libc环境下的字体渲染与macOS的glibc环境存在差异，节点文本的宽度计算错误会直接影响布局坐标的生成。
3. Alpine兼容性bug：Graphviz在musl libc（Alpine默认）下的布局计算可能存在未适配的bug，复杂节点连接的场景下触发了坐标计算错误。

调试步骤 #

• 核对版本：分别在本地和容器内执行dot -V，确认两者的Graphviz版本差异。
• 强制使用旧布局：在容器内执行命令时添加-Kdot参数，强制使用传统dot布局：

  dot -Kdot -Tsvg -Gsize=10,10\! -Gscale=1 -Eminlen=1 graph.dot -o output.svg
  

  检查生成的SVG是否正常。
• 移除布局参数：暂时去掉-Gsize=10,10\! -Gscale=1参数，观察基础布局是否正常，再逐步调整参数适配新版本。
• 确认字体加载：在容器内执行fc-list查看字体是否正确识别，或者在命令中明确指定字体：

  dot -Tsvg -Gfontname="DejaVu Sans" -Gsize=10,10\! -Gscale=1 -Eminlen=1 graph.dot -o output.svg
  

• 降级Graphviz版本：修改Dockerfile中的安装命令，尝试安装9.x版本：

  apk add --no-cache --update graphviz=9.0.0-r0 --repository="https://dl-cdn.alpinelinux.org/alpine/v3.19/community"
  

  重新构建镜像后测试布局是否正常。

修复方案 #

1. 强制旧布局：如果新版本的dot2是问题根源，长期使用-Kdot参数强制传统布局，保持与本地环境一致。
2. 适配新版本参数：若要使用新版本，调整size和scale参数，比如用-Gviewport替代size，或者修改scale值来适配新算法的坐标逻辑。
3. 提交官方bug：如果是musl环境下的兼容性问题，整理你的测试用例和环境信息，提交到Graphviz官方仓库，帮助修复该bug。

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