Zum Inhalt springen

Action kann nicht aufgelöst werden: Version nicht gefunden

Zuletzt aktualisiert am

Unable to resolve action bedeutet, dass GitHub die Action nicht herunterladen konnte, auf die Ihre uses:-Zeile verweist. Der Job ist daher gescheitert, bevor ein einziger Schritt ausgeführt wurde. Entweder existiert die Action-Referenz (Owner, Repository, Pfad oder Version) nicht, oder der Workflow darf sie nicht sehen. Diese Seite behandelt beide Fälle.

Die genaue Meldung

Error: Unable to resolve action `actions/checkout@v9`, unable to find version `v9`
Error: Unable to resolve action `some-org/some-action@v1`, repository not found
Error: Unable to resolve action `owner/repo@main`, unable to find version `main`

Ursache 1: Die Version existiert nicht

Der Tag, Branch oder Commit nach @ ist in diesem Repository nicht vorhanden. Typische Gründe sind ein Tippfehler, ein Major-Tag, den der Autor nie veröffentlicht hat (v3, obwohl nur v3.1.0 existiert), oder ein Tag, der gelöscht oder verschoben wurde. Prüfen Sie die Tags und Releases des Repositorys auf GitHub oder listen Sie sie auf:

git ls-remote --tags https://github.com/actions/checkout | tail

Verwenden Sie danach eine Version, die tatsächlich existiert:

- uses: actions/checkout@v4
# or, safer, a full commit SHA with the version in a comment:
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2

Ursache 2: Das Repository wurde umbenannt, verschoben oder gelöscht

repository not found bei einer Action, die früher funktioniert hat, bedeutet, dass der Owner sie umbenannt, archiviert und entfernt oder auf privat gestellt hat. Suchen Sie nach dem neuen Speicherort oder ersetzen Sie die Action durch eine andere oder durch einen einfachen run-Schritt.

Ursache 3: Die Action liegt in einem privaten Repository, auf das Sie keinen Zugriff haben

Eine Action in einem privaten Repository kann nur von Workflows verwendet werden, die sie sehen dürfen. Gehen Sie im Action-Repository zu Settings, Actions, General und wählen Sie unter "Access" die Option, den Zugriff aus anderen Repositories Ihrer Organisation (bzw. Ihres Benutzerkontos) zu erlauben. Ein Workflow in einer anderen Organisation kann sie auf diesem Weg nicht nutzen: Veröffentlichen Sie die Action öffentlich oder kopieren Sie sie in das Repository, das sie verwendet.

Ursache 4: Ihre Organisation beschränkt, welche Actions ausgeführt werden dürfen

Wenn die Richtlinie der Organisation oder des Repositorys nur bestimmte Actions erlaubt, schlägt eine gesperrte Action fehl oder wird mit einer Meldung abgelehnt, dass die Action nicht erlaubt ist. Unter Settings, Actions, General zeigt "Actions permissions" die Richtlinie. Bitten Sie einen Organisations-Owner, die Action zur Allow-List hinzuzufügen, oder verwenden Sie eine bereits erlaubte Action.

Ursache 5: Eine lokale Action ohne Checkout

Bei einer lokalen Action wie uses: ./.github/actions/setup muss der Code zuerst auf dem Runner liegen. Fügen Sie davor actions/checkout ein. Ohne diesen Schritt lautet der Fehler meist "Can't find 'action.yml'" und nicht diese Meldung, die Lösung ist aber dieselbe.

Ursache 6: Falscher Pfad für eine Action in einem Unterverzeichnis

Bei Actions in einem Unterordner lautet die Form owner/repo/path@ref. Ein fehlender Pfad oder ein falscher Ordnername führt zum Fehler.

- uses: github/codeql-action/init@v3

Ursache 7: Fehlerhafte Referenz auf einen wiederverwendbaren Workflow

Bei uses: org/repo/.github/workflows/build.yml@main muss der Pfad mit dem Namen der Workflow-Datei enden, die Datei muss auf dieser Referenz vorhanden sein und der aufrufende Workflow muss Zugriff darauf haben (gleiche Zugriffsregeln wie bei privaten Actions).

So verhindern Sie den Fehler

  1. Fixieren Sie Actions auf einen vollständigen Commit-SHA, mit einem Kommentar zur Version, und lassen Sie Dependabot sie aktualisieren. Siehe Dependabot einrichten.
  2. Prüfen Sie, ob ein Tag existiert, bevor Sie ihn referenzieren.
  3. Forken oder vendorn Sie Actions von Drittanbietern, von denen wichtige Pipelines abhängen.
  4. Prüfen Sie die Allow-List, wenn Sie eine neue Action hinzufügen, nicht erst, wenn der Build fehlschlägt.

FAQ

Liegt ein GitHub-Ausfall vor?

Das ist fast nie der Fall. Wenn viele unabhängige Workflows gleichzeitig Actions nicht herunterladen können, prüfen Sie die GitHub-Statusseite.

Warum funktioniert @v4 bei einer Action, @v1 aber bei einer anderen nicht?

Jedes Repository legt seine eigenen Tags fest. Nicht jede Action veröffentlicht bewegliche Major-Tags wie v1.

Kann ich einen Branch-Namen verwenden?

Ja, @main funktioniert, sofern der Branch existiert. Ein beweglicher Branch kann sich jedoch ändern. Ein SHA ist sicherer.

Wie finde ich heraus, welche Action fehlgeschlagen ist?

Die Meldung nennt sie in Backticks. Die erste fehlerhafte Zeile im Schritt "Set up job" zeigt die genaue Angabe owner/repo@ref.