Error: kill ESRCH
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
const pid = Number(fs.readFileSync("server.pid", "utf8"));
process.kill(pid);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ă
if (process.kill(pid, 0)) console.log("rulează");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
copil.on("exit", () => {});
setTimeout(() => process.kill(copil.pid), 5000);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ă 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.
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")}`);Procesul 3999999 nu mai rula server.pid exista: false
Indiciu
Pune process.kill(pid) într-un try și verifică err.code === "ESRCH" în catch.
Reparația
const fs = require("fs");
function opreste() {
const pid = Number(fs.readFileSync("server.pid", "utf8"));
try {
process.kill(pid);
console.log(`Am oprit procesul ${pid}`);
} catch (err) {
if (err.code !== "ESRCH") throw err;
console.log(`Procesul ${pid} nu mai rula`);
}
fs.rmSync("server.pid");
}
opreste();
console.log(`server.pid exista: ${fs.existsSync("server.pid")}`);De ce merge
Niciun proces nu are PID-ul 3999999, așa că sistemul de operare răspunde cu ESRCH. Pentru un script de oprire, asta înseamnă că serverul e deja oprit, deci nu e o eroare reală. catch tratează doar ESRCH și aruncă mai departe orice altceva (de exemplu EPERM), iar fișierul vechi e șters ca să nu încurce pornirea următoare.
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ă
ESRCHca „procesul nu mai rulează”, nu ca eroare fatală. - Șterge fișierul
.pidla 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
Error: listen EADDRINUSE: address already in use :::3000 Portul pe care vrei să pornești serverul e deja ocupat: o altă instanță a aplicației (pornită în alt terminal sau rămasă agățată) sau alt program îl folosește. Oprește procesul vechi (Ctrl+C, sau găsește-l cu lsof -i :3000) ori pornește serverul pe alt port. TypeError [ERR_INVALID_ARG_TYPE]: The "code" argument must be of type number. Received type string ('eroare') process.exit() și process.exitCode primesc un cod numeric: 0 înseamnă succes, orice altceva (de obicei 1) înseamnă eroare. De la Node 20, un text ca "eroare" nu mai e acceptat. Afișează mesajul cu console.error și ieși cu process.exit(1), sau setează process.exitCode = 1. Error: ENOENT: no such file or directory, open 'date.txt' Fișierul pe care vrei să-l deschizi nu există la calea dată, sau dosarul în care vrei să scrii lipsește. Calea relativă pornește din dosarul din care rulezi node, nu din dosarul scriptului. Verifică calea, construiește-o cu path.join(__dirname, ...) și creează dosarul înainte de scriere. Î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.
