Improved error message when a required os lib is missing

Ouverte
#1,651 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

@OKAN-SOFTWARE y travaille déjà.

Depuis le 30/10/2026.

  • #1656 par @OKAN-SOFTWARE — ouverte

Évaluation

Difficulté
3/5
Temps estimé
1-2 jours
Accessibilité débutants
55/100
Type d'issue
Fonctionnalité
Clarté
Plutôt claire
Activité
Active
Stack technique
github-actions, node.js, typescript, ubuntu

Piste de recherche

Start by tracing the Node installation and verification flow in the action; the issue does not name specific files or tests. Check how the action handles a failed Node executable and whether it can identify a missing system library such as libatomic1. Done means a failure caused by a missing library gives a clearer error than exit code 127, with relevant tests covering that message.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

feature request

Description:
When trying to upgrade our application from node 24 to 26 the setup node failed with the following error:

Run actions/setup-node@v7
Attempting to download 26.12.1...
Not found in manifest. Falling back to download directly from Node
Acquiring 26.12.1 - x64 from https://nodejs.org/dist/v26.12.1/node-v26.12.1-linux-x64.tar.gz
Extracting ...
/usr/bin/tar xz --strip 1 --warning=no-unknown-keyword --overwrite -C /home/runner/_work/_temp/80f11687-6f0f-4adc-850c-6c97cf44d2e0 -f /home/runner/_work/_temp/e4551be6-f2d4-4553-8e19-c7704a200d29
Adding to the cache ...
Done
Error: Node installation failed. Node may not be installed or not on PATH: The process '/home/runner/_work/_tool/node/26.12.1/x64/bin/node' failed with exit code 127

I figured out that our self hosted runners based on Ubuntu 24.04 did not have the required lib libatomic1 installed. After installing this it worked as expected. This was introduced as a requirement in node 25.

What would be great would be if the action could provide me with a better error message like. Node failed to install because of a missing system lib. Instead of exit code 127

Justification:
To make it easier to find out why the install failed.

Are you willing to submit a PR?

Yes

Langage dominant
TypeScript
Étoiles
5k
Forks
1.7k
Merge moyen
2 j 4 h
PR mergées (30 j)
1

Préparer son environnement

  • Aucun Dockerfile ni fichier Docker Compose
  • Propose un modèle de pull request
  • Aucun guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de actions/setup-node

Toutes les issues de actions/setup-node

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.