systemdサービスが起動しない・failedになる時の調査手順｜依存関係とユニット設定の直し方

この記事のポイント

・systemctl status → journalctl -xe の順で調査すれば原因の9割が特定できる
・failed の多くは ExecStart のパス誤り・実行権限・依存サービスの未起動が原因
・ユニットファイルを編集したら必ず daemon-reload を実行してから再起動する
・依存関係エラーは After/Requires の見直しか、依存先サービスの修正で解消できる

# サービス状態の確認（-l で長いメッセージも省略しない）
$ systemctl status myapp.service -l

* myapp.service - My Application Service
     Loaded: loaded (/etc/systemd/system/myapp.service; enabled; vendor preset: disabled)
     Active: failed (Result: exit-code) since Fri 2026-07-11 09:23:14 JST; 3min ago
    Process: 12847 ExecStart=/usr/local/bin/myapp --config /etc/myapp/app.conf (code=exited, status=203/EXEC)
   Main PID: 12847 (code=exited, status=203/EXEC)
        CPU: 2ms

Jul 11 09:23:14 server01 systemd[1]: myapp.service: Control process exited, code=exited, status=203/EXEC
Jul 11 09:23:14 server01 systemd[1]: myapp.service: Failed with result 'exit-code'.
Jul 11 09:23:14 server01 systemd[1]: Failed to start My Application Service.

# 直近のシステムジャーナルを確認（エラー前後のコンテキストが見やすい）
$ journalctl -xe

# 特定サービスのログのみ抽出（直近50行）
$ journalctl -u myapp.service -n 50

# 直近の起動失敗のみ表示（リアルタイム追跡）
$ journalctl -u myapp.service -f

# 優先度 error 以上のみ表示
$ journalctl -u myapp.service -p err

Jul 11 09:23:14 server01 systemd[1]: Starting My Application Service...
Jul 11 09:23:14 server01 systemd[1]: myapp.service: Control process exited, code=exited, status=203/EXEC
Jul 11 09:23:14 server01 systemd[1]: myapp.service: Failed with result 'exit-code'.
Jul 11 09:23:14 server01 systemd[1]: Failed to start My Application Service.
-- Subject: Unit myapp.service has failed
-- Defined-By: systemd
-- Support: https://access.redhat.com/support
-- Unit myapp.service has entered the 'failed' state with result 'exit-code'.

# ユニットファイルの内容を確認（読み込まれているすべての設定を表示）
$ systemctl cat myapp.service

# ユニットファイルを直接編集
$ systemctl edit --full myapp.service

# 設定値の有効状態を確認（dropinも含めた最終的な設定値）
$ systemctl show myapp.service

# /etc/systemd/system/myapp.service
[Unit]
Description=My Application Service
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/myapp --config /etc/myapp/app.conf
Restart=on-failure

[Install]
WantedBy=multi-user.target

# 実行ファイルの存在と権限を確認
$ ls -la /usr/local/bin/myapp
ls: cannot access '/usr/local/bin/myapp': No such file or directory

# インストール先を探す（which コマンドまたは find）
$ which myapp 2>/dev/null || find /usr /opt -name "myapp" -type f 2>/dev/null
/opt/myapp/bin/myapp

# 依存先サービスの状態確認
$ systemctl status postgresql.service

# 失敗しているサービスを一括確認
$ systemctl list-units --state=failed

# 全サービスの起動状態を確認
$ systemctl list-units --type=service --state=active

# 特定サービスの依存ツリーを表示
$ systemd-analyze critical-chain myapp.service

# ユニットファイルの文法チェック
$ systemd-analyze verify myapp.service

# 起動シーケンス全体のタイムライン確認
$ systemd-analyze plot > /tmp/boot-timeline.svg

systemd のトラブルシューティングをもっと体系的に学びたい方へ

Linux Master Pro Seminar では、systemd によるサービス管理・依存関係の設計・障害時の切り分け手順を、RHEL 9 実機を使ったハンズオンで習得できます。

セミナー詳細を確認する ＞＞

# 実行ファイルの確認
$ ls -la /opt/myapp/bin/myapp
-rwxr-xr-x 1 root root 2048576 Jul 10 14:30 /opt/myapp/bin/myapp

# 実行権限がない場合は付与する
$ chmod +x /opt/myapp/bin/myapp

# User= に指定するユーザーの存在確認
$ id myappuser
uid=1001(myappuser) gid=1001(myappuser) groups=1001(myappuser)

# Type=forking を使う場合の正しい書き方
[Service]
Type=forking
PIDFile=/var/run/myapp.pid
ExecStart=/opt/myapp/bin/myapp -D --pidfile /var/run/myapp.pid

# ユニットファイルを編集
$ vi /etc/systemd/system/myapp.service

# 編集後: daemon-reload で設定を再読み込み（必須）
$ systemctl daemon-reload

# サービスの再起動
$ systemctl restart myapp.service

# 起動を確認
$ systemctl status myapp.service

# 自動起動を有効化（OS 再起動後も起動）
$ systemctl enable myapp.service

# 自動起動の有効化と即時起動を同時に行う
$ systemctl enable --now myapp.service

# 自動起動状態の確認
$ systemctl is-enabled myapp.service
enabled

# 特定ポートの使用状況を確認（例: 8080番）
$ ss -tlnp | grep 8080
LISTEN 0 128 0.0.0.0:8080 0.0.0.0:* users:(("oldapp",pid=9923,fd=5))

# 占有しているプロセスを終了
$ kill 9923

# または systemd サービスの場合は stop
$ systemctl stop oldapp.service

# 依存関係エラーのログ確認
$ journalctl -u myapp.service | grep -i "dependency\|depend\|failed"

Jul 11 09:35:22 server01 systemd[1]: Dependency failed for My Application Service.
Jul 11 09:35:22 server01 systemd[1]: myapp.service: Job myapp.service/start failed with result 'dependency'.

# 依存先の状態確認
$ systemctl status postgresql.service
* postgresql.service - PostgreSQL Database Server
     Active: failed (Result: exit-code) since Fri 2026-07-11 09:34:50 JST

# 依存先を先に修正・起動してから自サービスを起動
$ systemctl start postgresql.service
$ systemctl start myapp.service

# ログでタイムアウトを確認
$ journalctl -u myapp.service | grep -i timeout
Jul 11 10:12:05 server01 systemd[1]: myapp.service: Start operation timed out. Terminating.

# ユニットファイルにタイムアウト値を追加
[Service]
TimeoutStartSec=300
# または無制限に設定（推奨しないが必要に応じて）
TimeoutStartSec=infinity