Shopify CLI構築で、テーマのダウンロード時に「An unexpected error occured.〜」というエラーが出る

日本語 ディスカッション 技術的なQ＆A

Topic summary

Shopify CLI 3.xへのアップグレード後、shopify theme devやshopify theme pullコマンド実行時に「An unexpected error occurred」エラーが発生。

試した解決策:

  • 過去の類似事例の記事を参照
  • Rubyバージョンの確認・更新
  • 再ログイン

いずれも効果なし。

使用環境:

  • Shopify CLI 3.21.0
  • Ruby 3.1.2p20
  • M1 MacBook Air (macOS Big Sur 11.7.1)

最終的な解決方法:
質問者が自己解決。新規ディレクトリを作成し、そのディレクトリ内でtheme pullを実行することで問題が解消された。具体的にはmkdirコマンドで新規ディレクトリを作成後、cdで移動してテーマをプルする手順で成功。

Summarized with AI on November 25. AI used: claude-sonnet-4-5-20250929.
1

お世話になります。

1:状況説明

Shopify CLIのバージョンが2.xから3.xに変わったため、それに従い構築を進めておりました。

Shopify CLIの接続までは正常に済みました。しかし、コマンドの「 Shopify theme dev 」や「Shopify theme pull 」を行うと、以下のエラーが出てしまいます。

An unexpected error occured.
	To submit an issue include the stack trace.
	To print the stack trace, add the environment variable SHOPIFY_CLI_STACKTRACE=1.

2:解決のため試したこと

・記事を検索し、2.0のバージョンですが同じ症状だったため下記の記事を試しましたが解決できませんでした。

https://www.evoworx.co.jp/blog/shopify-cli/

・rubyのバージョンの問題がないか確認し、古かったため最新にしましたが解決できません。

3:使用環境

・M1 macbook air （macOS Big Sur バージョン11.7.1）

・Shopify CLI version: 3.21.0

・rbenv versions system 3.1.2

・ruby 3.1.2p20 (2022-04-12 revision 4491bb740a)

エラー画面.png
エラー画面.png1138×280 63.8 KB

以上、お手数をおかけして申し訳ございませんが、よろしくお願いいたします。

2

Masatke様

はじめまして、フルバランスの園畑です。

ご質問を確認いたしました。

下記サイトにログインしなおしたら解決した、との記載がございますが、

こちらお試しいただけましたでしょうか？

https://zenn.dev/maneko/scraps/867afb20d7005a

3

株式会社フルバランス

園畑様

はじめまして。確認して下さりありがとうございます。

はい。ログインしなおして再度入り直すのは何度も試しました。

しかし解決することができません。テーマはversion3を使用しているため、

「shopify auth logout」でログアウトして、「shopify theme dev --store {my-store}」でログインをしています。

4

自己解決しました。

ディレクトリを新規に作成し、そのディレクトリに移動して theme pullすることで解決しました。ターミナルで以下のコマンドを入力して新規ディレクトリを作成

mkdir 好きなディレクトリ名

次のコマンドでそのディレクトリに移動

cd　　作成したディレクトリ名
2 Likes