next.jsでのファイルチャンク最適化の一例

今回は graphql-codegen を使い説明します。今回の例は、graphql-codegen 以外でも発生する可能性がありますが自動生成系が一番顕著に影響がわかりやすいです。

graphql-codegen はよく、graphql のスキーマから typescript の型定義/react の hooks 等を自動生成するのに使われますが、これは next.js と組み合わせた場合、少しトリッキーな部分があります。

GitHubCloud Security Alliance Star Level One BadgeGitHubDiscord

www.graphql-code-generator.com

graphql-codegen はデフォルトでは 1 ファイルにすべて出力されますが、それに対し next.js は各ページを chunks として吐くため何も考えずに実装すると、バンドルされるファイル量が膨大になる可能性があります。next.config.js から webpack の設定を上書きできますが、optimization はかなり上書きしづらくそもそも上書きは基本避けるべきなのでその手法は取るべきではないです。

例えば、A, B, C query を例に以下を見てみましょう。

1
// generated/hooks.ts <- codegenによって作られたファイル
2
import { gql } from "@apollo/client";
3
import * as Apollo from "@apollo/client";
4

5
export const ADocument = gql`
6
  query A {
7
    hero(episode: "JEDI") {
8
      name
9
    }
10
    droid(id: "2000") {
11
      name
12
    }
13
  }
14
`;
15

16
export function useAQuery(
17
  baseOptions?: Apollo.QueryHookOptions<AQuery, AQueryVariables>,
18
) {
19
  const options = { ...defaultOptions, ...baseOptions };
20
  return Apollo.useQuery<AQuery, AQueryVariables>(ADocument, options);
21
}
22
export function useALazyQuery(
23
  baseOptions?: Apollo.LazyQueryHookOptions<AQuery, AQueryVariables>,
24
) {
25
  const options = { ...defaultOptions, ...baseOptions };
26
  return Apollo.useLazyQuery<AQuery, AQueryVariables>(ADocument, options);
27
}
28
export const BDocument = gql`
29
  query B {
30
    hero(episode: "JEDI") {
31
      name
32
    }
33
    droid(id: "2000") {
34
      name
35
    }
36
  }
37
`;
38

39
export function useBQuery(
40
  baseOptions?: Apollo.QueryHookOptions<BQuery, BQueryVariables>,
41
) {
42
  const options = { ...defaultOptions, ...baseOptions };
43
  return Apollo.useQuery<BQuery, BQueryVariables>(BDocument, options);
44
}
45
export function useBLazyQuery(
46
  baseOptions?: Apollo.LazyQueryHookOptions<BQuery, BQueryVariables>,
47
) {
48
  const options = { ...defaultOptions, ...baseOptions };
49
  return Apollo.useLazyQuery<BQuery, BQueryVariables>(BDocument, options);
50
}
51
export const CDocument = gql`
52
  query C {
53
    hero(episode: "JEDI") {
54
      name
55
    }
56
    droid(id: "2000") {
57
      name
58
    }
59
  }
60
`;
61

62
export function useCQuery(
63
  baseOptions?: Apollo.QueryHookOptions<CQuery, CQueryVariables>,
64
) {
65
  const options = { ...defaultOptions, ...baseOptions };
66
  return Apollo.useQuery<CQuery, CQueryVariables>(CDocument, options);
67
}
68
export function useCLazyQuery(
69
  baseOptions?: Apollo.LazyQueryHookOptions<CQuery, CQueryVariables>,
70
) {
71
  const options = { ...defaultOptions, ...baseOptions };
72
  return Apollo.useLazyQuery<CQuery, CQueryVariables>(CDocument, options);
73
}

上記のファイルをバンドルすると以下のように出力されます。これは webpack が最適化を行うときに最初に tree shaking を行いすべての JS ファイルから import されているもののみを実行関数(今回の例だとe.dの引数のオブジェクト内のYW等がトリガー)として列挙します。つまり、全ページで使われていない query はこのe.dの箇所には列挙されないこととなります。 ただし、使われてない query も定義自体はされることに注意してください。

1
// query: A, query: B のみを誰かが使いCは使ってない出力結果
2
({
3
  7943: function (n, r, e) {
4
    "use strict";
5
    e.d(r, {
6
      YW: function () {
7
        return b;
8
      },
9
      $m: function () {
10
        return y;
11
      },
12
    });
13
    var t = e(6156),
14
      o = e(2465),
15
      u = e(7450),
16
      i = e(4569);
17
    function c() {
18
      var n = (0, o.Z)([
19
        '\n    query C {\n  hero(episode: "JEDI") {\n    name\n  }\n  droid(id: "2000") {\n    name\n  }\n}\n    ',
20
      ]);
21
      return (
22
        (c = function () {
23
          return n;
24
        }),
25
        n
26
      );
27
    }
28
    function a() {
29
      var n = (0, o.Z)([
30
        '\n    query B {\n  hero(episode: "JEDI") {\n    name\n  }\n  droid(id: "2000") {\n    name\n  }\n}\n    ',
31
      ]);
32
      return (
33
        (a = function () {
34
          return n;
35
        }),
36
        n
37
      );
38
    }
39
    function p() {
40
      var n = (0, o.Z)([
41
        '\n    query A {\n  hero(episode: "JEDI") {\n    name\n  }\n  droid(id: "2000") {\n    name\n  }\n}\n    ',
42
      ]);
43
      return (
44
        (p = function () {
45
          return n;
46
        }),
47
        n
48
      );
49
    }
50
    var d = {}, // <-- default options
51
      O = (0, u.Ps)(p());
52
    function b(n) {
53
      // <-- query: A
54
      var r = s(s({}, d), n);
55
      return i.a(O, r);
56
    }
57
    var v = (0, u.Ps)(a());
58
    function y(n) {
59
      // <-- query: B
60
      var r = s(s({}, d), n);
61
      return i.a(v, r);
62
    }
63
    (0, u.Ps)(c()); // <-- query: Cは使われてないので変数化されない
64
  },
65
});

たとえどこのファイルからも使われていない場合でも、生成ファイルに query(doc)があれば以下は出力に含まれます。使われている場合、上記の export の部分に含まれるだけであとは同じです。これは最も無駄な部分であり、更に gql が文字列だったりするのでファイルサイズを圧迫します。

1
function d() {
2
  var n = (0, u.Z)([
3
    '\n    query A {\n  hero(episode: "JEDI") {\n    name\n  }\n  droid(id: "2000") {\n    name\n  }\n}\n    ',
4
  ]);
5
  return (
6
    (d = function () {
7
      return n;
8
    }),
9
    n
10
  );
11
}

さて、問題点としてさっき言った next.js は各ページのエンドポイントを持つ点に戻った場合、生成されたファイルがグローバルな共通化された状態で全てのエンドポイントにこのコード(chunk の number も一緒) を挿入します。

つまり以下のようなことが発生します。

A ページが query: A を参照 -> generated ファイル(7943)が A の chunk に含まれる
B ページが query: B を参照 -> generated ファイル(7943)が B の chunk に含まれる
C ページが query: C を参照 -> generated ファイル(7943)が C の chunk に含まれる
D ページは何もよばない -> generated ファイル(7943)が D の chunk に含まれない

これは、A, B, C ページに無駄なコードが必ず含まれているということです。 A ページで query: A を呼んだだけにも関わらず他のページで使われている query がチャンクに存在し、これは A からすると不要です。本来これは、生成ファイルを一つに結合するべきではなくその親チャンクと結合し生成ファイルは分解されるべきです。

以下のようなコードを書いた時点で../generated/hooksを参照しているすべてのチャンクはそれぞれに最適化後の../generated/hooksを持つことになります。

1
import { useAQuery } from "../generated/hooks";

この問題を解決するには？

2 種類回避策があります。

_app に寄せる
大規模生成ファイルを分割する

自分の結論としては、2 つ目しかないですが、最悪 1 つ目でもキャッシュの観点からすれば前の例よりはマシとなります。

_app に寄せる

app は特殊なファイルとして位置づけられ、すべてのファイルで呼び出されます。つまり、app でこの大規模な 1 ファイルを呼ぶと各エントリーポイントにある../generated/hooksが昇格し、_app の中に入り各エントリーポイントからいなくなります。各エントリーポイントからすると、app を読み込んだときに不要な query が大量に入ることは変わらないですが、app はどこでも使うファイルなので一回読み込めばそのコード自体がキャッシュが効くためネットワーク効率は上がります。

大規模生成ファイルを分割する

query が増えていくと数千/万行になってエディタで見るのも大変になるので最適化以外の理由でも分けたほうがいいと思います。

幸いにも、graphql-codegen は near-operation-file を提供しているためそれを設定すれば完了です。

Cloud Security Alliance Star Level One BadgeGitHubDiscord

www.graphql-code-generator.com

1
schema: src/schema.json
2
documents: "src/**/*.gql"
3
generates:
4
  src/types.ts: # 型定義を逃がす
5
    - typescript
6
  src/: # hooksとかはこっち
7
    preset: near-operation-file
8
    presetConfig:
9
      baseTypesPath: types.ts # 上記のtypesをつなげる
10
    plugins:
11
      - typescript-operations
12
      - typescript-react-apollo

これを実行すると、各.gqlファイルの隣に ts のコードが生成されます。

1
documents/
2
├── a.generated.ts
3
├── a.gql
4
├── b.generated.ts
5
├── b.gql
6
├── c.generated.ts
7
└── c.gql

それを各エントリーポイントが import すればそのファイルだけが読み込まれるためファイルサイズは最小限となり、不要な query の定義も入ることはありません。また完全に無駄がなくなり scope hoisting されるため結合され無駄な関数実行が減ります。

concatenated と書かれている場合は、scope hoisting が効いてることがわかり、この例だと親のエントリーポイントとの結合がされています。

さいごに

結論としてこのケースの場合、最善な最適化はファイルを適切に分割することです。

next.js は、何も気にせずとも高品質なアプリケーションが作れますが、その分汎用的なものであるため必ずしも最適化が正しくなるとは限りません。ただバンドラの上書きはあまり良い方法ではないためチューニングしたい場合、上書き以外の方法を模索する必要があります。この例は graphql-codegen を用いた話でしたが、それに限らず大規模なファイルを扱った場合に発生し、パフォーマンスに影響する可能性があるため注意が必要です。

すべての出力ファイルコード

何もしない場合のエントリーポイントのチャンク(A ページ)

1
(self.webpackChunk_N_E = self.webpackChunk_N_E || []).push([
2
  [9],
3
  {
4
    3242: function (n, r, e) {
5
      "use strict";
6
      (e.r(r),
7
        e.d(r, {
8
          default: function () {
9
            return y;
10
          },
11
        }));
12
      var t = e(5893),
13
        o = e(6156),
14
        u = e(2465),
15
        i = e(7450),
16
        c = e(4569);
17
      function a() {
18
        var n = (0, u.Z)([
19
          '\n    query C {\n  hero(episode: "JEDI") {\n    name\n  }\n  droid(id: "2000") {\n    name\n  }\n}\n    ',
20
        ]);
21
        return (
22
          (a = function () {
23
            return n;
24
          }),
25
          n
26
        );
27
      }
28
      function f() {
29
        var n = (0, u.Z)([
30
          '\n    query B {\n  hero(episode: "JEDI") {\n    name\n  }\n  droid(id: "2000") {\n    name\n  }\n}\n    ',
31
        ]);
32
        return (
33
          (f = function () {
34
            return n;
35
          }),
36
          n
37
        );
38
      }
39
      function s(n, r) {
40
        var e = Object.keys(n);
41
        if (Object.getOwnPropertySymbols) {
42
          var t = Object.getOwnPropertySymbols(n);
43
          (r &&
44
            (t = t.filter(function (r) {
45
              return Object.getOwnPropertyDescriptor(n, r).enumerable;
46
            })),
47
            e.push.apply(e, t));
48
        }
49
        return e;
50
      }
51
      function p(n) {
52
        for (var r = 1; r < arguments.length; r++) {
53
          var e = null != arguments[r] ? arguments[r] : {};
54
          r % 2
55
            ? s(Object(e), !0).forEach(function (r) {
56
                (0, o.Z)(n, r, e[r]);
57
              })
58
            : Object.getOwnPropertyDescriptors
59
              ? Object.defineProperties(n, Object.getOwnPropertyDescriptors(e))
60
              : s(Object(e)).forEach(function (r) {
61
                  Object.defineProperty(
62
                    n,
63
                    r,
64
                    Object.getOwnPropertyDescriptor(e, r),
65
                  );
66
                });
67
        }
68
        return n;
69
      }
70
      function d() {
71
        var n = (0, u.Z)([
72
          '\n    query A {\n  hero(episode: "JEDI") {\n    name\n  }\n  droid(id: "2000") {\n    name\n  }\n}\n    ',
73
        ]);
74
        return (
75
          (d = function () {
76
            return n;
77
          }),
78
          n
79
        );
80
      }
81
      var O = {},
82
        b = (0, i.Ps)(d());
83
      (0, i.Ps)(f());
84
      (0, i.Ps)(a());
85
      var y = function () {
86
        (function (n) {
87
          var r = p(p({}, O), n);
88
          return c.a(b, r);
89
        })().data;
90
        return (0, t.jsx)("h1", { children: "top" });
91
      };
92
    },
93
    7878: function (n, r, e) {
94
      (window.__NEXT_P = window.__NEXT_P || []).push([
95
        "/a",
96
        function () {
97
          return e(3242);
98
        },
99
      ]);
100
    },
101
  },
102
  function (n) {
103
    n.O(0, [971, 774, 888, 179], function () {
104
      return ((r = 7878), n((n.s = r)));
105
      var r;
106
    });
107
    var r = n.O();
108
    _N_E = r;
109
  },
110
]);

_app に寄せた場合のエントリーポイントのチャンク(A ページ)

_app にすべての query が書かれている状態

1
(self.webpackChunk_N_E = self.webpackChunk_N_E || []).push([
2
  [9],
3
  {
4
    9217: function (n, u, t) {
5
      "use strict";
6
      t.r(u);
7
      var r = t(5893),
8
        _ = t(7943);
9
      u.default = function () {
10
        (0, _.YW)().data;
11
        return (0, r.jsx)("h1", { children: "top" });
12
      };
13
    },
14
    7878: function (n, u, t) {
15
      (window.__NEXT_P = window.__NEXT_P || []).push([
16
        "/a",
17
        function () {
18
          return t(9217);
19
        },
20
      ]);
21
    },
22
  },
23
  function (n) {
24
    n.O(0, [774, 888, 179], function () {
25
      return ((u = 7878), n((n.s = u)));
26
      var u;
27
    });
28
    var u = n.O();
29
    _N_E = u;
30
  },
31
]);

scope hoisting されたエントリーポイントのチャンク(A ページ)

1
(self.webpackChunk_N_E = self.webpackChunk_N_E || []).push([
2
  [9],
3
  {
4
    4462: function (n, r, e) {
5
      "use strict";
6
      (e.r(r),
7
        e.d(r, {
8
          default: function () {
9
            return b;
10
          },
11
        }));
12
      var t = e(5893),
13
        o = e(6156),
14
        c = e(2465),
15
        u = e(7450),
16
        i = e(4569);
17
      function f(n, r) {
18
        var e = Object.keys(n);
19
        if (Object.getOwnPropertySymbols) {
20
          var t = Object.getOwnPropertySymbols(n);
21
          (r &&
22
            (t = t.filter(function (r) {
23
              return Object.getOwnPropertyDescriptor(n, r).enumerable;
24
            })),
25
            e.push.apply(e, t));
26
        }
27
        return e;
28
      }
29
      function a(n) {
30
        for (var r = 1; r < arguments.length; r++) {
31
          var e = null != arguments[r] ? arguments[r] : {};
32
          r % 2
33
            ? f(Object(e), !0).forEach(function (r) {
34
                (0, o.Z)(n, r, e[r]);
35
              })
36
            : Object.getOwnPropertyDescriptors
37
              ? Object.defineProperties(n, Object.getOwnPropertyDescriptors(e))
38
              : f(Object(e)).forEach(function (r) {
39
                  Object.defineProperty(
40
                    n,
41
                    r,
42
                    Object.getOwnPropertyDescriptor(e, r),
43
                  );
44
                });
45
        }
46
        return n;
47
      }
48
      function p() {
49
        var n = (0, c.Z)([
50
          '\n    query A {\n  hero(episode: "JEDI") {\n    name\n  }\n  droid(id: "2000") {\n    name\n  }\n}\n    ',
51
        ]);
52
        return (
53
          (p = function () {
54
            return n;
55
          }),
56
          n
57
        );
58
      }
59
      var s = {},
60
        O = (0, u.Ps)(p());
61
      var b = function () {
62
        (function (n) {
63
          var r = a(a({}, s), n);
64
          return i.a(O, r);
65
        })().data;
66
        return (0, t.jsx)("h1", { children: "top" });
67
      };
68
    },
69
    7878: function (n, r, e) {
70
      (window.__NEXT_P = window.__NEXT_P || []).push([
71
        "/a",
72
        function () {
73
          return e(4462);
74
        },
75
      ]);
76
    },
77
  },
78
  function (n) {
79
    n.O(0, [971, 774, 888, 179], function () {
80
      return ((r = 7878), n((n.s = r)));
81
      var r;
82
    });
83
    var r = n.O();
84
    _N_E = r;
85
  },
86
]);

next.jsでのファイルチャンク最適化の一例

GitHubCloud Security Alliance Star Level One BadgeGitHubDiscord

この問題を解決するには？

_app に寄せる

大規模生成ファイルを分割する

Cloud Security Alliance Star Level One BadgeGitHubDiscord

さいごに

すべての出力ファイルコード

何もしない場合のエントリーポイントのチャンク(A ページ)

_app に寄せた場合のエントリーポイントのチャンク(A ページ)

scope hoisting されたエントリーポイントのチャンク(A ページ)

前後の記事

2021年を振り返る

2019年を振り返る

関連する記事

Next.jsのMiddlewareを単体テストする

Next.jsのApp Routerの機能別コードサンプル集を作った