フロントエンドリソースキャッシュ(CSS)の構成
Liferay DXP 2025年第4四半期以降
サイト上のページにアクセスすると、ページの読み込み時間は JavaScript や CSS などのフロントエンド リソースを取得する方法によって異なります。 キャッシュされたファイルは、ブラウザが Web サーバーから要求する必要があるファイルよりも速く取得されます。
Liferay のほとんどの CSS ファイルには、ビルド時にハッシュされたファイル名が付けられます。 たとえば、 clay.css ファイルは、実行時に、 clay.(tvERyCVfuRc).cssのように、名前にランダムに生成されたハッシュ値が含まれた状態で表示される場合があります。 このハッシュ値はこのファイルの一意のバージョンを表すため、ブラウザはファイルの内容が変更されていないことを識別できます。 これにより、ファイルは Liferay のキャッシュ に無期限に残ります。
多くの CSS リソースは無期限にキャッシュされるため、変更されたコンテンツでファイルが再デプロイされたときにのみ更新されますが、 一部のファイル にはキャッシュ内の有効期間 (TTL) が制限されています。 この時間が経過すると、次の要求では Web サーバーからファイルを再度取得する必要があります。
フロントエンドのキャッシュ動作の設定
ファイル が無期限にキャッシュされない場合、インスタンス設定でキャッシュの動作を設定できます。
-
管理者としてログインします。
-
アプリケーション (
) → インスタンス設定に移動します。 -
プラットフォームの下で、 インフラストラクチャをクリックします。
-
仮想インスタンススコープの下で、 フロントエンドキャッシュをクリックします。

このページでは、
CSS スタイルシートの最大有効期間ディレクティブ値: CSS ファイルの TTL (秒単位)。
CSS スタイルシートのキャッシュなしディレクティブを送信: CSS ファイルが更新されたかどうかをサーバーで強制的に確認するかどうか (キャッシュされたファイルが有効な場合でも)。
キャッシュが制限されたファイル
Liferay DXP がすぐに使用できるほとんどの CSS ファイルは、ファイルハッシュを自動的に使用するため、無期限にキャッシュされます。 上記の TTL 構成は適用されません。
ただし、これらの CSS ファイルは内容上ハッシュ化できないため、キャッシュ内の TTL が制限されます。
-
コンボサーブレットによって提供されるCSSファイル
-
動的に置き換えられるトークンを含む CSS ファイル (例:
@base_url@、、またはhttps://learn.lxc.liferay.com/o/dialect-theme/images)
CSS トークン値は非推奨であり、使用はお勧めしません。