シェルスクリプトの関数でreturnとexitを取り違えない設計｜errexitが効かない条件と終了ステータスの落とし穴

この記事のポイント

・bash関数内のreturnは関数だけを終了し、exitはスクリプト全体を終了する
・if文の条件式や&&・||リスト内の関数呼び出しではset -eが無効になる
・sourceで読み込んだライブラリ関数にexitを書くと呼び出し元シェルが終了する
・die()関数でexit呼び出しを一本化し、return 1と組み合わせるのが安全設計の基本

#!/bin/bash
greet() {
    echo "こんにちは"
    return 0          # 関数だけを終了して呼び出し元に戻る
    echo "ここは実行されない"
}

greet
echo "関数呼び出し後の処理"   # ← ちゃんと実行される

$ bash test_return.sh
こんにちは
関数呼び出し後の処理

#!/bin/bash
check_config() {
    if [ ! -f /etc/myapp/config.conf ]; then
        echo "設定ファイルがない" >&2
        exit 1   # 関数内でも、スクリプト全体が終了する
    fi
    return 0
}

check_config
echo "この行は実行されるか？"  # exitが呼ばれると実行されない

$ bash test_exit.sh
設定ファイルがない
$ echo $?
1

# lib.sh（共通ライブラリ）
cleanup() {
    rm -f /tmp/work.$$
    exit 0   # 危険：sourceした呼び出し元シェルも終了する
}

# main.sh
source lib.sh
cleanup
echo "この行は絶対に実行されない"  # exitで終了している

#!/bin/bash
set -e

check_func() {
    echo "関数開始"
    false       # set -eが有効なら即終了のはずだが……
    echo "falseの後も実行されてしまう"
}

echo "--- if条件内の呼び出し ---"
if check_func; then
    echo "成功"
else
    echo "失敗"
fi
echo "スクリプト継続"

$ bash test_errexit.sh
--- if条件内の呼び出し ---
関数開始
falseの後も実行されてしまう
失敗
スクリプト継続

#!/bin/bash
set -e

validate() {
    echo "バリデーション開始"
    false           # set -eが効かない
    echo "falseの後も続く"
    return 0
}

# &&の左辺に関数を置くケース
validate && echo "バリデーション成功"
echo "ここも実行される"

$ bash test_and.sh
バリデーション開始
falseの後も続く
バリデーション成功
ここも実行される

#!/bin/bash
set -e

is_root() {
    false    # set -eが効かない
    [ "$(id -u)" -eq 0 ]
}

if ! is_root; then
    echo "rootではない"
fi

#!/bin/bash
set -e

# スクリプト強制終了専用関数
die() {
    echo "ERROR: $*" >&2
    exit 1
}

# ライブラリ関数：returnだけを使う
check_config() {
    local file="$1"
    if [ ! -f "$file" ]; then
        return 1   # 呼び出し元に失敗を伝えるだけ
    fi
    return 0
}

# 呼び出し側でdie()と組み合わせる
check_config /etc/myapp/config.conf || die "設定ファイルが見つかりません: /etc/myapp/config.conf"
echo "設定ファイル確認完了"

#!/bin/bash
set -e

parse_config() {
    local file="$1"
    # set -eが無効になる文脈を想定して、明示的にエラー処理する
    if [ ! -f "$file" ]; then
        echo "ERROR: $file が存在しない" >&2
        return 1
    fi
    grep -q "^enabled=true" "$file" || {
        echo "ERROR: enabled=trueの設定がない" >&2
        return 1
    }
    return 0
}

# 関数をif条件に使う場合は、関数内でエラー処理を完結させる
if parse_config /etc/myapp/config.conf; then
    echo "設定読み込み成功"
else
    echo "設定の読み込みに失敗" >&2
    exit 1
fi

# 曖昧な例（最後のコマンドの結果に依存する）
setup_dir() {
    mkdir -p /var/myapp/logs
    chmod 750 /var/myapp/logs   # これが失敗すると関数が1を返す
    # return の明示なし
}

# 明示的な例
setup_dir_safe() {
    mkdir -p /var/myapp/logs || return 1
    chmod 750 /var/myapp/logs || return 1
    return 0
}