WordPress6.9.1以降で「The style with the handle “〇〇” was enqueued with dependencies that are not registered: ××.」とnoticeが出た時の対処例

公開日:2026(令和8)年1月30日/最終更新日:

WordPress Trouble Shooting and Repair | Personal WP Customization Notes (PWCN)

サイトの維持や有用なページの紹介を目的として、このページには各所に広告を表示しています。多数の広告が表示され、閲覧しにくいところがあるかも知れませんが、ご協力いただけますようお願いいたします。

「The style with the handle “〇〇” was enqueued with dependencies that are not registered: ××.」を意訳すると、「〇〇というハンドル名のスタイルをエンキュー(読み込み)しようとした際に依存する登録済みスタイルシートのハンドル名××がありませんよ」ということをnotice(注意)として表示しているものです。

以下が私のサイトで実際に表示された全文です。

Notice: 関数 WP_Styles::add が誤って呼び出されました。The style with the handle “haup-only-frontend-style” was enqueued with dependencies that are not registered: global-styles. 詳しくは WordPress のデバッグをご覧ください。 (このメッセージはバージョン 6.9.1 で追加されました) in /…/wp-includes/functions.php on line 6131

私の場合は、プラグインでエンキューしている「haup-only-frontend-style」というハンドル名のスタイルシートを「global-styles」というハンドル名を持つWordPressコアスタイルシートの直後に読み込むように記述していたところ、上記のような注意が表示されました。

調べてみると、「global-styles」は、フロントエンドのみで出力される(いつのバージョンからそうなっているのかは不明)ようになっていて、エンキューするのに「enqueue_block_assets」へフックさせてフロントとブロックエディター側へ同時にエンキューしようとして、ブロックエディター側に「global-styles」がないから意図した通りの順序で読み込まれないかもしれないよということのようです。

ソースコードで確認した限りでは、ブロックエディター側では「global-styles-css-custom-properties」というのが読み込まれているようなので、以下の例のように管理画面とフロントエンドで別のハンドルを依存するハンドル名にすることで解決できました。

	if(is_admin()){
		wp_enqueue_style( 'ハンドル名', ファイルの場所, array('global-styles-css-custom-properties'), バージョン );
	}else{
		wp_enqueue_style( 'ハンドル名', ファイルの場所,array('global-styles'), バージョン );
	}

恐らくWordPress 6.9までは、ターゲットとなるハンドル名が存在しない場合は無視して適当な位置(コードの読み込まれた順に従った位置)に何事もなくエンキューしていたものを、より厳密に精査して注意を出すようにしたのだと思われます。

,
Lolipop ServerMoshimo Ad x-serverMoshimo Ad

WordPress Trouble Shooting and Repair | Personal WP Customization Notes (PWCN)
ブロックテーマを使用したサイトでCLSの問題が発生するときの確認と対処例