Mermaid 렌더러가 다이어그램을 3일 동안 렌더링했지만 아무도 볼 수 없었던 이유: SVG 텍스트가 보이지 않는 잉크였다

요약

Mermaid를 이용해 다이어그램 렌더링 API를 구축했으나, 실제 사용자 환경에서 빈 사각형이 나오는 문제를 발견했습니다. 원인은 SVG가 서버에 없는 글꼴을 참조하고 있었고, 이를 보는 클라이언트(Slack, GitHub 등)는 누락된 글꼴 때문에 아무것도 렌더링하지 않았기 때문입니다.

핵심 포인트

• SVG 출력은 유효해도 실제로 보이지 않을 수 있습니다.
• 글꼴이 없는 환경에서 다이어그램을 테스트할 때는 주의해야 합니다.
• 해결책으로 서버에 DejaVu Sans 같은 기본 글꼴을 설치하고 명시적으로 설정하는 것이 필요합니다.