...
Eroare Node.js · Proces, terminal și intrare de la tastatură

Error: kill ESRCH

Pe scurt

process.kill(pid) a fost apelat pentru un proces care nu mai există (ESRCH = no such process), de obicei un PID vechi rămas într-un fișier .pid după o oprire bruscă. Prinde eroarea: dacă err.code === "ESRCH", procesul e deja oprit, deci șterge fișierul .pid și continuă.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

process.kill(pid, semnal) trimite un semnal (implicit SIGTERM) altui proces. Dacă sistemul de operare nu găsește niciun proces cu acel PID, apelul eșuează cu ESRCH (de la „search”: procesul căutat nu există). Mesajul conține doar numele apelului de sistem (kill) și codul.

Situații tipice:

  • un script de oprire citește PID-ul serverului dintr-un fișier server.pid, dar serverul s-a oprit deja (crash, repornire a calculatorului), iar fișierul a rămas;
  • trimiți semnalul după ce procesul copil s-a terminat singur;
  • verifici dacă un proces rulează cu process.kill(pid, 0), fără să tratezi cazul în care nu rulează.

Înrudit: kill EPERM înseamnă că procesul există, dar nu ai drept să-l oprești (aparține altui utilizator).

De ce apare: cauzele frecvente

1Fișier .pid rămas de la o rulare veche

Greșit
JavaScript
const pid = Number(fs.readFileSync("server.pid", "utf8"));
process.kill(pid);
Corect
JavaScript
const pid = Number(fs.readFileSync("server.pid", "utf8"));
try {
  process.kill(pid);
} catch (err) {
  if (err.code !== "ESRCH") throw err;
}
fs.rmSync("server.pid", { force: true });

ESRCH înseamnă că procesul e deja oprit, adică exact rezultatul dorit; doar ștergi fișierul vechi.

2Verificare dacă procesul rulează

Greșit
JavaScript
if (process.kill(pid, 0)) console.log("rulează");
Corect
JavaScript
function ruleaza(pid) {
  try {
    process.kill(pid, 0);
    return true;
  } catch (err) {
    return err.code === "EPERM";
  }
}

Semnalul 0 nu oprește procesul, doar verifică dacă există. Lipsa lui se semnalează prin excepție, nu prin false.

3Proces copil deja terminat

Greșit
JavaScript
copil.on("exit", () => {});
setTimeout(() => process.kill(copil.pid), 5000);
Corect
JavaScript
setTimeout(() => {
  if (copil.exitCode === null) copil.kill();
}, 5000);

copil.kill() nu aruncă excepție dacă procesul s-a terminat, iar exitCode arată dacă mai rulează.

Repară tu

Repară eroarea, direct în pagină

Scriptul opreste citește PID-ul serverului din server.pid și îi trimite process.kill. Serverul s-a oprit însă de mult (fișierul a rămas de la o pană de curent), iar scriptul se oprește cu kill ESRCH. Tratează cazul: dacă procesul nu mai există, afișează un mesaj, șterge fișierul .pid și arată că a fost șters.

Codul care dă eroarea
JavaScript
const fs = require("fs");

function opreste() {
  const pid = Number(fs.readFileSync("server.pid", "utf8"));
  process.kill(pid);
  console.log(`Am oprit procesul ${pid}`);
  fs.rmSync("server.pid");
}

opreste();
console.log(`server.pid exista: ${fs.existsSync("server.pid")}`);
După reparație, programul afișează
Procesul 3999999 nu mai rula
server.pid exista: false
Indiciu

Pune process.kill(pid) într-un try și verifică err.code === "ESRCH" în catch.

Alte forme ale mesajului

  • Error: kill ESRCH at process.kill (node:internal/process/per_thread:277:13)
  • Error: kill EPERM
  • [Error: kill ESRCH] { errno: -3, code: 'ESRCH', syscall: 'kill' }
  • TypeError [ERR_INVALID_ARG_TYPE]: The "pid" argument must be of type number. Received type string ('4120')

Cum o eviți pe viitor

  • Tratează ESRCH ca „procesul nu mai rulează”, nu ca eroare fatală.
  • Șterge fișierul .pid la oprirea normală (process.on("exit")) și verifică-l la pornire.
  • Convertește PID-ul citit din fișier cu Number(...); un string dă altă eroare.
  • Pentru procese pornite de tine, folosește obiectul copil (copil.kill(), copil.exitCode) în loc de PID-uri salvate.

Întrebări frecvente

E periculos să trimit kill unui PID vechi?

Poate fi: sistemul refolosește PID-urile, deci un PID vechi poate aparține acum altui proces. De aceea scripturile serioase verifică și numele procesului sau folosesc un manager de procese (systemd, pm2).

Ce înseamnă kill EPERM?

Procesul există, dar aparține altui utilizator (de exemplu a fost pornit cu sudo) și nu ai voie să-i trimiți semnale.

Erori înrudite

← Toate erorile Node.js

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Node.js de la zero, cu exerciții la fiecare lecție

Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.