Job for xxx.service failedの原因と対処法|systemctlでサービスが起動しない
このエラーは、「サービスの起動処理が、エラーで終了した」ことを意味し、原因そのものはまだ表示されていません。メッセージの指示どおり、systemctl status サービス名とjournalctl -xeu サービス名で、サービス自身が出したエラーを読むのが最初の一歩です。
このエラーが表示される例
Job for nginx.service failed because the control process exited with error code.
See "systemctl status nginx.service" and "journalctl -xeu nginx.service" for details.
「Job for xxx.service failed because the control process exited with error code」の意味
systemdは、サービスの起動コマンドを実行し、その終了コードで成否を判断します。設定ファイルの誤り、ポートの重複、ファイルの権限、依存するサービスの停止など、原因はサービスによってさまざまです。
このメッセージは「失敗した」という結果だけを伝えるもので、原因はサービスのログに出ています。
原因を切り分ける手順
ステップ1:状態と直近のログを確認する
$ systemctl status nginx --no-pager -l
$ sudo journalctl -xeu nginx --no-pager | tail -n 30Active: failedの下や、ログの最後のほうに、サービス自身のエラーが出ています。
ステップ2:設定ファイルの構文を確認する
$ sudo nginx -t
$ sudo sshd -t
$ sudo apachectl configtest設定を変更した直後の失敗は、構文の誤りが最も多い原因です。サービスごとの検査コマンドを使います。
ステップ3:ポートの重複や権限を確認する
$ sudo ss -tlnp | grep ':80 '
$ ls -l /var/log/nginx/Address already in useならポートの重複、Permission deniedならファイルやディレクトリの権限が原因です。
原因別の対処法
設定の誤りを直す
ログに出ている行番号を手がかりに直し、検査コマンドでokになってから起動します。直前の変更が原因なら、バックアップに戻すのが確実です。
ポートを使っているプロセスを確認する
ss -tlnpで見つかった別のプロセスを止めるか、設定のポートを変えます。
権限や置き場所を直す
ログやPIDファイルの置き場所が無い、権限が無いといった場合は、ディレクトリを作成し、所有者を合わせます。
失敗の回数制限を解除する
何度も失敗するとstart request repeated too quicklyで起動できなくなります。原因を直してからsudo systemctl reset-failed サービス名を実行します。
原因を確認しないまま、何度も
restartを繰り返すのは避けましょう。ログが流れて原因が追いにくくなり、回数制限にも引っかかります。
まずログを読んでから対処します。
再発を防ぐために
設定を変更したら、反映の前に必ず構文チェックを行い、変更前のバックアップを取っておく運用にします。反映後はsystemctl statusでactive (running)を確認するところまでを、作業手順に含めましょう。
よくある質問
journalctl に何も出てきません
ログの保存先がサービス独自のファイル(/var/log/nginx/error.logなど)になっていることがあります。そちらも確認します。
status では active なのに、すぐ failed になります
起動直後に終了しているか、再起動を繰り返しています。journalctl -u サービス名 -fで追いかけながら起動してみます。
ほかのエラーメッセージを調べる
Connection refusedConnection timed outTemporary failure in name resolutionREMOTE HOST IDENTIFICATION HAS CHANGEDbad interpreter: No such file or directoryArgument list too longToo many open filesAddress already in useRead-only file systemOperation not permittedis not in the sudoers fileKilled(Out of memory)No space left on devicecommand not foundPermission denied (publickey)Device or resource busyText file busyNo such file or directoryCould not get lock /var/lib/dpkg/lock-frontendsudo: unable to resolve hostSegmentation fault (core dumped)