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 30

Active: 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で追いかけながら起動してみます。

この記事を書いた人:
こすけ(コマンド学習道場 運営者)。
AWSの運用保守に携わるエンジニアで、保有資格はCCNA・AWS-SAA・LPIC-3(305)。
詳しくは運営者情報をご覧ください。

ほかのエラーメッセージを調べる

← エラーメッセージ辞典へ戻る