ApexCharts と ECharts は SSR で落ちない。dynamic import が必須なのは Plotly.js だけ

訂正react-apexcharts 2.2.0echarts-for-react 3.0.6plotly.js-dist-min 4.2.0
訂正。誤:ApexCharts・ECharts は SSR 非対応。正:SSR で落ちるのは Plotly.js だけ

このサイトのグラフのページには、長いあいだ「ApexCharts・ECharts は SSR 非対応のため dynamic import が必要」と書いてありました。実際に確かめたところ、これは Plotly.js では正しく、ApexCharts と ECharts の React ラッパーでは不正確でした。説明を直したので、確かめた結果を残します。

確かめた結果

Node.js(window が無い環境)でそれぞれを import し、renderToString でサーバー側の出力を作りました。

ライブラリサーバーでの結果dynamic import(ssr: false)
plotly.js-dist-min 4.2.0import した時点で ReferenceError: self is not defined必須
echarts-for-react 3.0.6空の <div>(高さだけ付く)を返す。落ちない必須ではない
react-apexcharts 2.2.0空の <div> を返す。落ちない必須ではない

それでも dynamic import を使う理由

ApexCharts と ECharts は、サーバーでは空の要素を返し、ブラウザで描画します。落ちはしませんが、グラフそのものはサーバーの HTML に入りません。そしてどちらもバンドルが大きいので、このサイトでは引き続き dynamic import で遅延読み込みをしています。理由が「落ちるから」ではなく「初期表示を軽くするため」に変わった、ということです。

tsx
import dynamic from 'next/dynamic';

// Plotly.js:サーバーで import すると落ちるので、ssr: false が必須
const Plot = dynamic(() => import('react-plotly.js'), { ssr: false });

// ECharts・ApexCharts:必須ではない。バンドルが大きいので遅延読み込みにしている
const ReactECharts = dynamic(() => import('echarts-for-react'), { ssr: false });

直したところ

  • ECharts の特徴の文(8 ページ)と ApexCharts の特徴の文(7 ページ)を、「SSR でも落ちない。バンドルが大きいため dynamic import で遅延読み込みしている」に直しました。
  • データの可視化・グラフの「実装の落とし穴」と、よくある質問「SSR でチャートが表示されない」を、ライブラリごとに書き分けました。
  • Plotly.js の説明は正しかったので、そのままです。

ライブラリを選ぶとき、「SSR で落ちるかどうか」と「サーバーの HTML にグラフが入るかどうか」は別の話です。「非対応」とひとまとめにせず、分けて確かめるのがよさそうです。

動くデモで確かめる

出典

この記事は、2026/11/04 の時点で、上のバージョンで確かめた内容です。