コンテンツへスキップ

Process Completed With Exit Code 127:コマンドが見つからない

最終更新:

Process completed with exit code 127 は、シェルが実行を求められたコマンドを見つけられなかったことを意味します。その数行上で command not found または No such file or directory を探してください。原因は、ランナーにツールがインストールされていないこと、PATH にそのツールが含まれていないこと、スクリプトのパスが誤っていること、またはスクリプトファイルがWindowsの改行コードになっていることです。

表示される正確なメッセージ

/home/runner/work/_temp/abc123.sh: line 1: pnpm: command not found
Error: Process completed with exit code 127.
./deploy.sh: No such file or directory
Error: Process completed with exit code 127.

原因1:ツールがランナーにインストールされていない

ホステッドイメージには多くのツールが含まれていますが、すべてが含まれているわけではありません。runs-on ラベルに対応するランナーイメージのソフトウェア一覧を確認し、不足しているものはセットアップアクションまたはパッケージマネージャーでインストールしてください:

- uses: pnpm/action-setup@v4
- uses: actions/setup-node@v4
  with:
    node-version: 22
    cache: pnpm
- run: pnpm install --frozen-lockfile

Ubuntuのシステムパッケージの場合:

- run: sudo apt-get update && sudo apt-get install -y jq

ubuntu-latest からセルフホステッドランナーやサードパーティのランナーに移行した場合、そのイメージにはGitHubのイメージにあるツールが不足している可能性があります。切り替える前に比較してください。

原因2:インストールされているが PATH に含まれていない

あるステップでインストールしたツールは、そのディレクトリを GITHUB_PATH ファイルに追加しない限り、次のステップの PATH には含まれません。この目的で export PATH=... を使わないでください。それは現在のステップにしか影響しないためです。

- run: |
    curl -fsSL https://example.com/tool.tar.gz | tar xz -C "$HOME/tool"
    echo "$HOME/tool/bin" >> "$GITHUB_PATH"
- run: tool --version

原因3:スクリプトのパスが誤っている、または実行権限がない

./script.sh: No such file or directory と Permission denied は、作業ディレクトリからの相対パスが誤っているか、ファイルに実行権限がないことを意味します。working-directory を確認し、Gitでファイルを実行可能にしてください:

chmod +x scripts/deploy.sh
git update-index --chmod=+x scripts/deploy.sh

または、インタープリターを経由して呼び出してください。この方法は実行権限を必要としません:run: bash scripts/deploy.sh。

原因4:Windowsの改行コード(CRLF)

CRLFの改行コードで保存されたスクリプトは、シバン行に目に見えないキャリッジリターンを含むため、システムは bash\r という名前のインタープリターを探し、ファイルが存在するにもかかわらず「No such file or directory」と報告します。次のように変換してください:

sed -i 's/\r$//' scripts/deploy.sh

さらに、.gitattributes ファイルを使って再発を防いでください:

*.sh text eol=lf

原因5:タイプミスまたは誤ったシェル

Linuxではコマンド名は大文字と小文字を区別します。shell: pwsh のステップはbashとは異なるコマンドを持つPowerShellで実行され、shell: cmd のステップではbashの構文を実行できません。

原因6:コンテナジョブ内のバイナリが不足している

ジョブで container: を使う場合、ツールはランナーではなくそのイメージから提供されます。必要なものを含むイメージを使用してください。

予防方法

  1. ジョブの開始時にバージョンを出力すると(node --version、docker --version)、ツールが不足している場合に早い段階で明確に失敗します。
  2. ツールが存在していると仮定するのではなく、バージョンを固定したセットアップアクションでインストールしてください。
  3. .gitattributes を使って、スクリプトが実行可能でLF改行になるように維持してください。
  4. 同じステップをクリーンなコンテナでローカル実行し、お使いのマシンに依存した前提を洗い出してください。

よくある質問

終了コード127とは何を意味しますか?

POSIXシェルでの「Command not found」です。シェルがプログラムを見つけられない、または実行できない場合に返されます。

なぜ自分のマシンではそのコマンドが動くのですか?

お使いのマシンには、そのツールがインストールされ PATH に含まれています。ランナーはクリーンな状態で、各ステップを新しいシェルで開始します。

126と127の違いは何ですか?

126はファイルは見つかったものの実行できなかったことを意味し、多くの場合は権限が原因です。127はファイルがまったく見つからなかったことを意味します。

WindowsとmacOSのランナーではセットアップは異なりますか?

はい。イメージごとにツールの一覧が異なるため、使用するラベルのソフトウェア一覧を確認してください。