PaaS のみ

デフォルトの Varnish 設定を変更する必要があるために発生した 503 エラーのトラブルシューティング

最終更新日： 2025年5月5日

作成対象：

  • 管理者

この記事では、特定の Varnish Cache のデフォルト値がストアに十分でないことが原因で発生した 503 エラーのトラブルシューティングに対する解決策を提供します。

問題

Adobe Commerceで使用されるキャッシュタグの長さが Varnish のデフォルトの 8192 バイトを超えている場合、ブラウザーに HTTP 503 （バックエンドの取得に失敗しました）エラーが表示される可能性があります。 エラーは次のように表示される場合があります。"Error 503 Backend fetch failed. バックエンドの取得に失敗しました」

解決策

この問題を解決するには、Varnish 設定ファイルの http_resp_hdr_len パラメーターのデフォルト値を増やします。 http_resp_hdr_len パラメーターは、ヘッダーの最大の長さ この値の範囲内、デフォルトの応答サイズの合計 32768 バイト）を指定します。

メモ
http_resp_hdr_len 値が 32,000 を超える場合は、http_resp_size パラメーターを使用してデフォルトの応答サイズも大きくする必要があります。

  1. root 権限を持つユーザーとして、Vanish 設定ファイルをテキストエディターで開きます。

    • CentOS 6:/etc/sysconfig/varnish
    • CentOS 7: /etc/varnish/varnish.params
    • Debian: /etc/default/varnish
    • Ubuntu: /etc/default/varnish

  2. http_resp_hdr_len パラメーターを検索します。

  3. パラメーターが存在しない場合は、thread_pool_max の後に追加します。

  4. 最大カテゴリの製品数に 21 を掛けた値に http_resp_hdr_len を設定します。 （1 つの製品タグの長さは約 21 文字です。） 例えば、最大のカテゴリの製品が 3,000 個ある場合、値を 65536 バイトに設定しても機能します。 例： conf -p http_resp_hdr_len=65536 \

  5. 応答ヘッダーの長さの増加に対応する値に http_resp_size を設定します。 例えば、増加したヘッダーの長さとデフォルトの応答サイズの合計を使用することは、出発点として適切です（例：65536 + 32768 = 98304）。-p http_resp_size=98304。 スニペットは次のとおりです。

    # DAEMON_OPTS is used by the init script.
DAEMON_OPTS="-a ${VARNISH_LISTEN_ADDRESS}:${VARNISH_LISTEN_PORT} \
    -f ${VARNISH_VCL_CONF} \
    -T ${VARNISH_ADMIN_LISTEN_ADDRESS}:${VARNISH_ADMIN_LISTEN_PORT} \
    -p thread_pool_min=${VARNISH_MIN_THREADS} \
    -p thread_pool_max=${VARNISH_MAX_THREADS} \
    -p http_resp_hdr_len=65536 \
    -p http_resp_size=98304 \
    -p workspace_backend=98304 \
    -S ${VARNISH_SECRET_FILE} \
    -s ${VARNISH_STORAGE}" \