app.service: Main process exited, code=exited, status=1/FAILURE
Programul pornit de serviciu a rulat, dar s-a oprit singur cu codul de ieșire 1, adică a raportat o eroare. Motivul real e în jurnal, chiar deasupra acestei linii: citește-l cu journalctl -u app -n 30. Des e un fișier găsit doar din alt folder (lipsește WorkingDirectory) sau o variabilă lipsă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
systemd îți spune că procesul principal al serviciului (Main process) s-a terminat normal (code=exited), cu codul 1, pe care systemd îl numește FAILURE. Spre deosebire de 203/EXEC, aici programul chiar a pornit; el însuși a decis să se oprească. Urmează de obicei Failed with result 'exit-code', iar cu Restart=on-failure serviciul repornește până la start-limit-hit.
Motivul e scris de program în ieșirea lui, pe care systemd o pune în jurnal, deci journalctl -u app -n 30 sau systemctl status app (ultimele linii). Cauza cea mai frecventă la început: programul merge din terminal, dar nu ca serviciu, pentru că systemd îl pornește din folderul /, ca root (sau alt User=), cu un mediu minim, fără variabilele din .bashrc și fără PATH-ul tău.
De ce apare: cauzele frecvente
1Căi relative, fără WorkingDirectory
[Service]
ExecStart=/home/elev/app/start.sh[Service]
WorkingDirectory=/home/elev/app
ExecStart=/home/elev/app/start.shFără WorkingDirectory, procesul pornește din /, iar config.ini relativ nu e găsit. Apoi sudo systemctl daemon-reload și restart.
2Variabile de mediu din .bashrc
# în .bashrc: export DB_HOST=localhost
ExecStart=/home/elev/app/start.shEnvironment=DB_HOST=localhost
ExecStart=/home/elev/app/start.shServiciile nu citesc .bashrc. Variabilele se dau în unitate cu Environment= sau EnvironmentFile=.
3Alt utilizator, fără drepturi
User=www-data
ExecStart=/home/elev/app/start.shUser=elev
ExecStart=/home/elev/app/start.shUtilizatorul serviciului trebuie să poată citi fișierele aplicației; altfel programul primește Permission denied și iese cu 1.
Repară eroarea, direct în pagină
Serviciul app pornește scriptul /home/elev/app/start.sh, care citește config.ini din folderul lui. Din terminal, din folderul app, merge, dar sudo systemctl start app se termină cu Main process exited, code=exited, status=1/FAILURE. Citește jurnalul, repară unitatea /etc/systemd/system/app.service și pornește serviciul, ca să rămână activ.
Indiciu
Jurnalul spune ce fișier nu e găsit; systemd pornește programul din folderul /.
Reparația
journalctl -u app -n 5
sudo sed -i 's|^ExecStart=|WorkingDirectory=/home/elev/app\nExecStart=|' /etc/systemd/system/app.service
sudo systemctl daemon-reload
sudo systemctl restart app
systemctl is-active appRezultat (ultima comandă):
activeDe ce merge
Jurnalul arăta Nu gasesc config.ini: scriptul caută fișierul relativ la folderul curent, iar systemd pornește serviciile din /, nu din folderul aplicației.
WorkingDirectory=/home/elev/app face ca procesul să pornească din folderul aplicației, deci config.ini e găsit. daemon-reload încarcă unitatea modificată, iar restart pornește serviciul din nou, care acum rămâne active.
Alte forme ale mesajului
Main process exited, code=exited, status=1/FAILUREapp.service: Failed with result 'exit-code'.Active: failed (Result: exit-code)Process: 1210 ExecStart=/home/elev/app/start.sh (code=exited, status=1/FAILURE)app.service: Main process exited, code=exited, status=2/INVALIDARGUMENT
Cum o eviți pe viitor
- Testează programul exact cum îl pornește systemd: din
/, cu calea completă (cd / && /home/elev/app/start.sh). - Pune în unitate
WorkingDirectory=,User=și variabilele necesare. - Fă programul să scrie un mesaj clar pe stderr înainte de
exit 1, ca jurnalul să explice problema. - După orice modificare a unității:
sudo systemctl daemon-reload, apoirestart, apoistatus.
Întrebări frecvente
Unde văd de ce a ieșit cu 1?
În jurnal: journalctl -u app -n 30 --no-pager sau journalctl -xeu app. Mesajele programului apar etichetate cu numele lui, de exemplu start.sh[1210]: Nu gasesc config.ini.
Ce înseamnă alte coduri, de exemplu status=127?
Codurile vin de la program. Pentru scripturi bash, 127 înseamnă de obicei că o comandă din script nu a fost găsită (mediul serviciului are alt PATH), iar 126 că un fișier nu poate fi executat.
Erori înrudite
magazin.service: Main process exited, code=exited, status=203/EXEC systemd nu a putut porni programul din ExecStart: calea e greșită, fișierul nu e executabil (lipsește chmod +x), lipsește shebang-ul sau e scris cu CRLF. Citește linia Failed at step EXEC din journalctl -u magazin, repară cauza și rulează sudo systemctl restart magazin. magazin.service: Start request repeated too quickly. Serviciul a căzut imediat după pornire de mai multe ori la rând (implicit de 5 ori în 10 secunde), iar systemd a încetat să-l mai repornească. Caută cauza căderii în journalctl -u magazin, repar-o, apoi rulează sudo systemctl reset-failed magazin și sudo systemctl start magazin. Job for nginx.service failed because the control process exited with error code. Serviciul a încercat să pornească, dar programul s-a oprit cu eroare, de obicei din cauza unei configurări greșite. Citește motivul cu systemctl status nginx și journalctl -xeu nginx (la nginx, sudo nginx -t arată linia greșită), repară și pornește din nou. Învață Linux de la zero, cu exerciții la fiecare lecție
Curs Linux: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
