Job for X.service failed because the control process exited with error code

Qué comprobar, y en qué orden

En el orden en que lo miramos nosotros. No es un ranking de frecuencia: no publicamos estadísticas que no hemos medido.

1. 1

   El programa falla al arrancar por su propia configuración. El journal lo muestra literalmente.

   Comprobar

   sudo journalctl -u mi-servicio -n 50 --no-pager

   Corregir

   # Corregir lo que indique el journal y reintentar:
   sudo systemctl start mi-servicio

2. 2

   ExecStart no es una ruta absoluta o el binario no existe. systemd no resuelve el PATH.

   Comprobar

   systemctl cat mi-servicio | grep ExecStart
   ls -l /ruta/al/binario

   Corregir

   # Poner la ruta absoluta en ExecStart y recargar:
   sudo systemctl daemon-reload

3. 3

   El usuario del servicio no puede leer el directorio de trabajo o escribir donde necesita.

   Comprobar

   systemctl cat mi-servicio | grep -E 'User|WorkingDirectory'
   sudo -u el_usuario ls /ruta/de/trabajo

   Corregir

   sudo chown -R el_usuario:el_grupo /ruta/de/trabajo

4. 4

   El endurecimiento de la unidad bloquea algo que el servicio necesita. ProtectSystem=strict deja el sistema en solo lectura salvo lo declarado.

   Comprobar

   systemd-analyze security mi-servicio

   Corregir

   # Declarar los directorios donde tiene que escribir en vez de quitar la
   # protección:
   #   ReadWritePaths=/var/lib/mi-servicio

5. 5

   El Type no corresponde con lo que hace el proceso. Con Type=forking systemd espera que se bifurque; si no lo hace, da el arranque por fallido.

   Comprobar

   systemctl cat mi-servicio | grep Type

   Corregir

   # La mayoría de los servicios modernos no se demonizan: Type=simple.
   sudo systemctl daemon-reload && sudo systemctl start mi-servicio