Linuxのcronが「動かない」と3時間格闘した日の話|SE時代の体験と現役講師が語るcron3つの落とし穴

HOME > リナックスマスター.JP 公式ブログ > Linux学習ガイド > Linuxのcronが「動かない」と3時間格闘した日の話|SE時代の体験と現役講師が語るcron3つの落とし穴
運営:リナックスマスター.JP(代表 宮崎智広)
「夜中に動くはずのcronジョブが、昨日から止まっている。」

SE時代の2003年頃、客先のLinuxサーバーを管理していたときのことです。前日の深夜0時に実行されるはずだった定期バックアップが動いていないと気づいたのは、翌朝の作業確認中でした。バックアップファイルのタイムスタンプが昨日のまま止まっています。「設定は変えていない。一昨日まで動いていた。なぜだ」と3時間近く格闘した末に原因が判明したとき、思わず苦笑いが漏れました。

この記事では、20年以上サーバーを運用してきた経験から、あの日の失敗が教えてくれた「cronが動かないときに最初に疑うべき3つのポイント」についてお話しします。

この記事のポイント

・cronが動かない原因の多くは、ターミナルとcronの実行環境の違いにある
・スクリプトに実行権限(chmod +x)が設定されているか、cronに登録する前に必ず確認する
・/var/log/cronのログで「cronが実行されたか」という事実を最初に確認する
・cron設定後は1分刻みのテスト実行でログ確認するのが鉄則
・cronの実際の環境変数は「env > /tmp/cron-env.txt」で自分の目で確認できる


Linuxのcronが「動かない」と3時間格闘した日の話|SE時代の体験と現役講師が語るcron3つの落とし穴
「このままじゃマズい」と感じていませんか?
参考書を開く気力もない、同年代に取り残される不安——
でも安心してください。プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら

「設定は正しいはず」という思い込みが3時間を奪った

cronを疑い始めたとき、私がまず確認したのはcrontabの設定でした。

# crontab -l の出力(当時の設定・ホスト名はマスク済み) 0 0 * * * /home/admin/backup.sh >> /var/log/backup.log 2>&1

設定は書かれている。書き方のフォーマットも正しい。タイムゾーンの問題でもない。それなのになぜ動かないのか。

3時間の間に確認したことは次の3つです。

・crontabの設定内容を3回見直した
・サーバーの時刻(date コマンド)を確認した
・cronデーモン(crond)が動いているか確認した

crondは問題なく起動していました。サーバーの時刻もあっていました。設定の書き方も文法的に正しかった。しかし気づかなかった落とし穴が3つあったのです。

後から気づいたことですが、バックアップスクリプトを手動で実行すると問題なく動いていたこともあり、「cronには登録されているし手動では動く。なぜだ」という思考ループに入っていました。この「手動では動くのにcronだと動かない」という現象は、セミナーでも定番の相談で、今でも受講生に最初に解説するトピックの一つです。

ターミナルからスクリプトを手動実行するときと、cronがスクリプトを実行するときでは、実行環境が根本的に異なります。この違いを最初に理解しておくと、「cronが動かない」問題のほとんどは原因の当たりがつくようになります。

cronが動かない本当の理由|SE時代に踏み抜いた3つの落とし穴

1. 環境変数(PATH)がターミナルと全く違う

cronが実行するスクリプトの環境変数(PATH)は、ターミナルでログインしたときとは別物です。これが3時間格闘した原因の一つでした。

ターミナルでは ~/.bash_profile や /etc/profile によって /usr/local/bin などにパスが通っていますが、cronの実行環境でのPATHは最小限しか設定されていません。

# ターミナルで確認したPATH(ログイン環境) # echo $PATH /usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/root/bin # cron実行環境でのPATH(デフォルト・非常に短い) /usr/bin:/bin

バックアップスクリプトの中でフルパスを書かずに呼び出していたコマンドが、cron実行時には「コマンドが見つからない(command not found)」でエラーになっていたのです。しかしそのエラーはバックアップログにも表示されず、気づくまでに時間がかかりました。

セミナーで3,100名以上を指導してきた中で、この環境変数の問題はcronでつまずくケースの中で最も多い原因です。受講生から「cronが動かない」という相談があると、まず最初にこのPATHの問題を確認するようにしています。

cronの実際の環境変数を自分の目で確認する

「自分のサーバーでcronがどんな環境変数で動いているか確認したい」という場合は、一時的なcronジョブを追加して記録させる方法が確実です。

# crontabに一時エントリを追加して環境変数を記録する(確認後は必ず削除する) # crontab -e で以下を追記(現在時刻の次の分を指定する) * * * * * env > /tmp/cron-env.txt # 1分後に確認する # cat /tmp/cron-env.txt SHELL=/bin/sh HOME=/root LOGNAME=root PATH=/usr/bin:/bin LANG= # ↑ /usr/local/bin 等のパスは一切含まれていない

この出力を確認すると、PATHの短さが一目でわかります。確認後は crontab -e でこのエントリを削除するのを忘れずに。

解決策は3つあります。いずれも実務でよく使う方法です。

・スクリプトの先頭でPATHを明示的に設定する
・コマンドをすべてフルパスで記述する(which コマンド名 でフルパスを確認できる)
・crontabファイルの冒頭でPATHを設定する(全ジョブに適用される)

#!/bin/bash # 方法1:スクリプト先頭でPATHを設定する PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin export PATH # 方法2:コマンドをフルパスで書く(例:rsyncの場合) # which rsync でフルパスを確認してから書く /usr/bin/rsync -az /home/admin/data/ /backup/data/

# 方法3:crontabファイルの冒頭でPATHとSHELLを設定する(全ジョブに一括適用) # crontab -e で開いて、ジョブ定義より前に以下を追記する SHELL=/bin/bash PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin # 以降にジョブ定義 0 0 * * * /home/admin/backup.sh >> /var/log/backup.log 2>&1

SHELL=/bin/bash を設定しておくと、cronのデフォルトシェルである /bin/sh ではなく bash で実行されます。bash固有の構文を使ったスクリプトでは、この設定が特に重要です。

また、スクリプト内でチルダ(~)を使ったパス指定(~/backup)や相対パスを使っている場合も注意が必要です。cronの実行環境では ~ の展開が動作しないケースや、カレントディレクトリがスクリプトの置き場所と異なるケースがあります。スクリプト内のファイル・ディレクトリの参照はすべて絶対パスで書いておくと、実行環境に左右されません。

2. スクリプトに実行権限が設定されていなかった

cronで実行するシェルスクリプトに、実行権限(chmod +x)を設定することを忘れていたのが2つ目の落とし穴でした。

ターミナルから手動で動かすときは bash /home/admin/backup.sh と呼び出していたので実行権限がなくても動いていました。しかしcrontabには /home/admin/backup.sh と直接パスを書いていたため、cronが実行しようとするとPermission deniedで失敗していたのです。

# 権限の確認(実行権限がない状態) # ls -l /home/admin/backup.sh -rw-r--r-- 1 admin admin 512 3月 15 09:23 backup.sh # ↑ 先頭の3桁が rw- で x がない = 実行権限なし # 実行権限を付与する # chmod +x /home/admin/backup.sh # 確認 # ls -l /home/admin/backup.sh -rwxr-xr-x 1 admin admin 512 3月 15 09:23 backup.sh # ↑ x が付いた = 実行権限あり

この落とし穴は習慣で防げます。私が現場でよく見かけるのが、スクリプトを作った直後に chmod を忘れるパターンです。20年来のルールは「スクリプトを書いたらすぐ chmod +x」です。ファイルを保存したらすぐ実行権限を設定する、これだけで詰まる時間が大幅に減ります。

また、本番のcronに登録する前に、cronと同じ最小限の環境でスクリプトが動くかどうかを確認する習慣も有効です。

# cronに近い環境でスクリプトをテストする(本番登録前の確認) # 環境変数を最小限に絞って実行する # env -i HOME=/root PATH=/usr/bin:/bin /home/admin/backup.sh # ↑ これでエラーが出なければ、cronでも動く可能性が高い # ↑ エラーが出るなら、そこが本番cronでも失敗する箇所になる

もう一点、実行権限の問題と合わせて確認してほしいのが、スクリプトの文字コードです。

Windowsのテキストエディタで作成したスクリプトをLinuxサーバーにコピーした場合、改行コードがCRLF(Windows形式)になっていることがあります。LinuxのシェルはCRLFのスクリプトを正しく解釈できず、実行しても「コマンドが見つからない」という不可解なエラーが発生します。

# 文字コードを確認する # 「with CRLF line terminators」と表示されたら変換が必要 # 出力例(環境により異なります) file /home/admin/backup.sh # backup.sh: Bourne-Again shell script, ASCII text executable, with CRLF line terminators # dos2unix コマンドで LF に変換する(dos2unix がない場合は dnf install dos2unix) dos2unix /home/admin/backup.sh # 変換後に確認する file /home/admin/backup.sh # backup.sh: Bourne-Again shell script, ASCII text executable

3. cronのログを最初から確認していなかった

3時間格闘した中で最も反省しているのが、cronのログを最初から確認しなかったことです。

「cronは実行されているはずだ」という思い込みがあったため、ログ確認を後回しにしていました。しかし実際にはcronが実行しようとしてエラーになっていたのです。ログを最初に確認していれば15分で解決できていたはずでした。

cronの実行記録は /var/log/cron(CentOS/RHEL系)に残ります。

# /var/log/cronの直近の記録を確認する(ホスト名はマスク済み) # tail -20 /var/log/cron Mar 16 00:00:01 srv-xx CROND[4821]: (admin) CMD (/home/admin/backup.sh >> /var/log/backup.log 2>&1) Mar 16 00:00:01 srv-xx CROND[4822]: (admin) CMD failed: backup.sh: /usr/bin/rsync: No such file or directory Mar 17 00:00:01 srv-xx CROND[5103]: (admin) CMD (/home/admin/backup.sh >> /var/log/backup.log 2>&1) Mar 17 00:00:01 srv-xx CROND[5104]: (admin) CMD failed: backup.sh: /usr/bin/rsync: No such file or directory

「CMD failed」という文字がはっきり記録されています。今ならすぐ「フルパスの問題だ」と気づきますが、当時はログを確認していなかったので、このエラーに3時間後まで気づきませんでした。

なお、systemdを採用しているLinux(RHEL系では8以降)では、journalctl でもcronのログを確認できます。

# systemdを使うシステムでcronのログを確認する # journalctl -u crond --since "today" --no-pager | tail -20 # cronデーモンの動作状態も確認する # systemctl status crond

受講生からよく聞かれる質問が「cronが動かないときどこから調べればいいですか?」です。私の答えは常に同じです。「まず /var/log/cron を tail -20 で確認してください。cronが実行されたかどうかという事実を、まず確認することが大切です。」

もう一点、地味に重要なのが「エラー出力をファイルに残す」ことです。crontabの設定に 2>&1 を書いてスクリプトのエラー出力もログに記録しておくと、何が起きたか一目でわかります。ここを /dev/null に捨てている設定は、問題が起きたときのデバッグを数倍難しくします。

# NG:エラー出力を捨てている(問題が起きても何も手がかりが残らない) 0 0 * * * /home/admin/backup.sh > /dev/null 2>&1 # 推奨:標準出力とエラー出力の両方をログに残す 0 0 * * * /home/admin/backup.sh >> /var/log/backup.log 2>&1

どのコマンドで失敗しているかをピンポイントで特定したいときは、スクリプトの先頭に set -x を追加するデバッグモードが便利です。また、スクリプトの文法エラーは bash -n スクリプト名 で事前に確認できます。

#!/bin/bash # スクリプト先頭でデバッグモードを有効にする(確認後は必ず外す) set -x # 以降のコマンドが実行される都度、+ コマンド の形でログに出力される # 実行例(どの行でエラーが出たかが一目でわかる): # + /usr/bin/rsync -az /home/admin/data/ /backup/data/ # bash: /usr/bin/rsync: No such file or directory

# スクリプトの文法エラーを事前に確認する(cronに登録する前に) # bash -n /home/admin/backup.sh # ↑ エラーが出なければ文法的には問題ない # ↑ エラーが出た行番号と内容が表示される

現役講師が教えるcron設定後の確認4ステップ

あの失敗から20年以上が経ちますが、今もcronを設定したときに必ず実施している確認手順があります。受講生にも毎回お伝えしている4ステップです。

1. crontabの内容を保存後すぐ確認する

crontab -e で設定を保存したら、すぐに crontab -l で設定が反映されているか目視確認します。書き方のミスや意図しない削除が起きていないかを最終確認する習慣です。

# crontab -l で設定内容を確認する # crontab -l 0 0 * * * /home/admin/backup.sh >> /var/log/backup.log 2>&1

2. テスト用に1分刻みのcronを設定してログで動作確認する

本番のcronを設定する前に、まずテスト用として「毎分実行」のcronを設定して /var/log/cron に記録が出るか確認します。実際に記録が出ていればcron自体は動いていることが確認できます。

# テスト用:毎分実行するcronを設定する(動作確認後に必ず削除する) * * * * * echo "cron-test" >> /tmp/cron-test.log # 1分後にログを確認する # tail -5 /tmp/cron-test.log cron-test cron-test # ↑ 記録されていれば cron は正常に動作している # 確認が取れたらテスト用cronを削除する # crontab -e ← テスト行を削除する

3. 本番スクリプトの実行権限とPATHを確認してから登録する

本番のcronを登録する前に、スクリプト自体を単独実行してエラーが出ないか確認します。さらに、スクリプト先頭にPATHの明示的な設定と実行権限(chmod +x)が設定されているかを確認してから登録するのが鉄則です。

# 1. 実行権限の確認と付与 # ls -l /home/admin/backup.sh -rw-r--r-- 1 admin admin 512 Mar 15 09:23 backup.sh # chmod +x /home/admin/backup.sh # 2. スクリプトをcronと同じ環境(最小PATH)で動作確認する # env -i PATH=/usr/bin:/bin /home/admin/backup.sh # ↑ エラーが出なければcronでも動く可能性が高い # 3. スクリプト先頭でPATHが設定されているか確認する # head -5 /home/admin/backup.sh #!/bin/bash PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin export PATH

Windowsで作成したスクリプトをLinuxへコピーした場合は、CRLFの確認も忘れずに行ってください。

# CRLFの確認と変換 # file /home/admin/backup.sh # ↑ 「with CRLF line terminators」と出たら dos2unix コマンドで変換する dos2unix /home/admin/backup.sh

4. crontabのバックアップを取る

「crontab -r」と「crontab -e」は1文字違いです。誤操作でcrontabの内容を全削除してしまうリスクは常にあります。念のため、定期的にcrontabの内容をバックアップする習慣をつけておくと安心です。

# crontabの内容をバックアップする(rootのcrontabの場合) # crontab -l > /root/crontab-backup-$(date +%Y%m%d).txt # /var/spool/cron/ 配下のファイルを直接コピーする方法もある # cp /var/spool/cron/root /root/crontab-backup-$(date +%Y%m%d).txt

本記事のまとめ

あの日の3時間の格闘を一言でまとめると、「cronが動かない原因のほとんどは、cronの実行環境を理解していないことにある」です。

ターミナルでは動くのにcronでは動かない。その差のほとんどは環境変数・実行権限・ログ未確認の3点に集約されます。
症状 原因 対処法
cronが実行されない(ログに記録がない) crondが停止 / crontabの記述ミス systemctl status crond でcrond起動確認
cronは実行されているがスクリプトが失敗する スクリプト内でエラーが発生している /var/log/cronでエラーメッセージを確認
「command not found」エラー cronのPATHが最小限(/usr/bin:/binのみ) スクリプト先頭でPATHを明示設定 / フルパス指定
「Permission denied」エラー スクリプトに実行権限がない chmod +x でスクリプトに実行権限を付与
手動では動くがcronでは動かない ログイン環境とcron環境の差 env -i PATH=/usr/bin:/bin スクリプトで事前確認
エラーの原因が不明 エラー出力を捨てている(/dev/null) 2>&1 でエラーをログファイルに記録する
原因不明の「コマンドが見つからない」エラー スクリプトの改行コードがCRLF(Windows形式) dos2unix コマンドで LF に変換する
crontabの書き方や設定の詳細については「crontabコマンドの設定と書き方|動かない時のログ確認まで」も参考にしてください。cronのログの読み方については「cronのログファイル「/var/log/cron」を確認する」もあわせてご覧ください。

「cronは動く」という自信を、最初から正しい型で身につけませんか?

環境変数・実行権限・ログ確認。この3点を最初から体系的に学んでいれば、3時間の格闘は防げました。ネットの断片情報を拾い集めるより、現場で通用する安全なLinuxサーバー構築の「型」を体系的に身につけたい方へ、『Linuxサーバー構築入門マニュアル(図解60P)』を完全無料でプレゼントしています。

※ 「独学の時間がもったいない」「プロから直接、現場の技術を最短で学びたい」という本気の方には、2日で実務レベルのスキルが身につく【初心者向けLinuxセミナー(2日間ハンズオン)】も開催しています。

<PR>手元に置いて学びを深める1冊

新しいLinuxの教科書 第2版

cronの実行環境やシェルスクリプトの書き方を含め、Linuxの基本を体系的に理解したい方への入門書です。

無料メルマガで学習を続ける

Linuxの実践スキルをメールで毎週お届け。
登録は30秒、解除もいつでも可。

登録無料・いつでも解除できます

暗記不要・1時間後にはサーバーが動く

3,100名以上が実践した「型」を無料で公開中

プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
その「型」を図解60Pにまとめた入門マニュアルを、完全無料でプレゼントしています。

姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら

Linux無料マニュアル(図解60P) 名前とメールで30秒登録

運営

リナックスマスター.JP(代表 宮崎智広)

株式会社イーネットマーキュリーが運営するLinux教育サイトです。代表の宮崎智広は現役のLinuxサーバー管理者として20年以上の実務経験を持ち、累計3,100名以上のエンジニアを指導してきました。実践型のLinuxセミナーや無料マニュアルの配布を通じてLinux人材の育成に取り組んでいます。