trapコマンドでbashスクリプトのシグナルを捕捉・処理する方法｜一時ファイル削除やエラー終了処理の実践例も

この記事のポイント

・trap はbash組み込みコマンドでシグナル受信時に任意の処理を実行できる
・trap "rm -f /tmp/$$.lock" EXIT で終了時に一時ファイルを自動削除できる
・INT/TERM/ERRの3シグナルを押さえれば実務の9割のケースに対応できる
・trap '' SIGINT でシグナルを無視し、重要処理を割り込みから守れる

# 基本構文
trap '実行するコマンド' シグナル名またはイベント名

# 複数コマンドは ; で区切るか、関数を呼び出す
trap 'echo "中断しました"; exit 1' INT TERM

# trapの登録解除（空文字でリセット）
trap '' INT      # シグナルを無視する（空文字）
trap - INT       # デフォルト動作に戻す（ハイフン）

#!/bin/bash

# 一時ファイルを変数で管理
TMPFILE=$(mktemp /tmp/myapp.XXXXXX)

# EXIT トラップで確実に削除
cleanup() {
    echo "クリーンアップ中..." >&2
    rm -f "$TMPFILE"
}
trap cleanup EXIT

# 以降の処理（途中でCtrl+Cしても cleanup が呼ばれる）
echo "データを処理中..."
some_command > "$TMPFILE"
cat "$TMPFILE"

# スクリプトを実行し、途中でCtrl+Cした場合
$ bash cleanup_demo.sh
データを処理中...
^C
クリーンアップ中...
$ ls /tmp/myapp.*
ls: cannot access '/tmp/myapp.*': No such file or directory
# ファイルが確実に削除されている

#!/bin/bash
LOCKFILE="/var/run/myapp.lock"

# ロックファイルの存在チェック
if [ -f "$LOCKFILE" ]; then
    echo "エラー: 別のプロセスが実行中です（$LOCKFILE）" >&2
    exit 1
fi

# ロックファイルを作成し、EXIT で削除する
touch "$LOCKFILE"
trap 'rm -f "$LOCKFILE"; echo "ロック解除完了"' EXIT

echo "処理開始: PID=$$"
# ... 本処理 ...
sleep 10
echo "処理完了"

#!/bin/bash
set -e   # エラーで即終了

# ERR トラップでエラー行番号とコマンドを記録
error_handler() {
    local exit_code=$?
    local line_no=$1
    echo "[ERROR] 行 ${line_no} でエラーが発生しました（終了コード: ${exit_code}）" >&2
    echo "[ERROR] コマンド: ${BASH_COMMAND}" >&2
}
trap 'error_handler $LINENO' ERR

# テスト: 存在しないディレクトリへ移動
cd /nonexistent_dir
echo "ここには到達しない"

# 実行結果
$ bash error_demo.sh
bash: cd: /nonexistent_dir: No such file or directory
[ERROR] 行 12 でエラーが発生しました（終了コード: 1）
[ERROR] コマンド: cd /nonexistent_dir

#!/bin/bash
set -eu   # -e: エラーで終了 / -u: 未定義変数でエラー

SCRIPT_NAME=$(basename "$0")
LOCKFILE="/var/run/${SCRIPT_NAME%.sh}.lock"
LOGFILE="/var/log/${SCRIPT_NAME%.sh}.log"
TMPFILE=$(mktemp)

log() { echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*" | tee -a "$LOGFILE"; }

cleanup() {
    local exit_code=$?
    rm -f "$TMPFILE" "$LOCKFILE"
    if [ "$exit_code" -ne 0 ]; then
        log "異常終了 (exit_code=${exit_code})"
    else
        log "正常終了"
    fi
}
trap cleanup EXIT

error_handler() {
    log "ERR: 行 $1 / コマンド: ${BASH_COMMAND}"
}
trap 'error_handler $LINENO' ERR

# 二重起動チェック
if [ -f "$LOCKFILE" ]; then
    log "別プロセスが実行中のためスキップ"
    exit 0
fi
touch "$LOCKFILE"

log "処理開始"
# --- ここに本処理を書く ---
log "処理完了"

#!/bin/bash

echo "保護区間の前: Ctrl+C で中断できます"
sleep 3

# シグナルを無視（空文字でtrap）
trap '' INT TERM
echo "保護区間開始: ここではCtrl+Cが無効です"
sleep 5   # 重要な処理（DBバックアップ等）
echo "保護区間終了"

# デフォルト動作に戻す
trap - INT TERM
echo "ここからはCtrl+Cで中断できます"
sleep 3

# NG: サブシェル内のtrapは親シェルに影響しない
( trap 'echo "サブシェル"' EXIT )

# OK: 親シェルで直接trap
trap 'echo "親シェル"' EXIT

# NG: grep が0件マッチで終了コード1 → set -e でスクリプト終了
grep "pattern" file.txt

# OK: || true で終了コードを0に揃える
grep "pattern" file.txt || true

# 現在のtrap設定を一覧表示
trap -p

# 特定のシグナルだけ確認
trap -p EXIT INT TERM