Архитектура ошибки и симптомы сбоя

Синтаксическая ошибка «Unit app.service has invalid ExecStart= syntax (or path is not absolute)» генерируется диспетчером systemd при попытке загрузить или запустить юнит. Диспетчер systemd не использует стандартную командную оболочку (sh/bash) для вызова ExecStart=. Ошибка указывает на нарушение правил парсинга: указан относительный путь к исполняемому файлу вместо абсолютного, используются неэкранированные пайпы (|), редиректы (>, <), подстановки переменных или множественные команды без вызова shell.

Диагностическая таблица параметров сбоя

Пошаговое дерево решений и сценарии траблшутинга

Сценарий 1: Исправление относительного пути на абсолютный

Найдите точный путь к бинарному файлу с помощью утилиты which или whereis:

# Поиск абсолютного пути к утилите:
which python3
which npm

# НЕПРАВИЛЬНО в unit-файле:
# ExecStart=python3 app.py

# ПРАВИЛЬНО:
# ExecStart=/usr/bin/python3 /opt/app/app.py

Сценарий 2: Корректное использование пайпов и редиректов через bash -c

Если команде требуются конвейеры (|), перенаправления в файл (>>) или сложные логические цепочки (&&):

# Оберните команду в явный вызов командного интерпретатора:
[Service]
ExecStart=/bin/bash -c '/usr/bin/app_binary | /usr/bin/tee -a /var/log/app.log 2>&1'

Сценарий 3: Передача переменных окружения и аргументов

Используйте синтаксис ${VAR} и обязательно задайте директиву Environment=:

[Service]
Environment="PORT=8080" "ENV=production"
ExecStart=/usr/bin/app_server --port=${PORT} --mode=${ENV}

Сценарий 4: Проверка валидности и перезапуск юнита

# Проверка синтаксиса юнита утилитой systemd-analyze:
systemd-analyze verify app.service

# Применение исправлений:
sudo systemctl daemon-reload
sudo systemctl restart app.service