【bat】バッチファイルのエラー処理でよくある15の失敗例と正しい書き方

注意：ERRORLEVELという名前のユーザー環境変数を set ERRORLEVEL=0 のように定義すると、システムのERRORLEVELが参照できなくなります。set ERRORLEVEL= （値なし）で解除しない限り、すべてのエラー判定が狂うので要注意です。

@echo off

rem 3つのコマンドを順に実行
copy source.txt dest.txt
del temp.txt
mkdir output

rem 最後にまとめてエラーチェック（NG）
if %ERRORLEVEL% neq 0 (
    echo エラーが発生しました
    exit /b 1
)
echo すべて正常に完了しました

@echo off

copy source.txt dest.txt
if %ERRORLEVEL% neq 0 (
    echo [ERROR] copy に失敗しました
    exit /b 1
)

del temp.txt
if %ERRORLEVEL% neq 0 (
    echo [ERROR] del に失敗しました
    exit /b 1
)

mkdir output
if %ERRORLEVEL% neq 0 (
    echo [ERROR] mkdir に失敗しました
    exit /b 1
)

echo すべて正常に完了しました

ポイント：各コマンドの直後にERRORLEVELを判定するのが鉄則です。もう1つの方法として && 演算子でコマンドを連結し、途中で失敗した時点で後続を実行しない書き方もあります（例: copy source.txt dest.txt && del temp.txt && mkdir output）。

@echo off

somecommand.exe
echo 処理が完了しました

rem ここでの判定対象は somecommand ではなく echo
if errorlevel 1 (
    echo エラーが発生しました
    exit /b 1
)

注意：echo以外にも、set、title、rem なども ERRORLEVELを変更する可能性があります。判定前には余計なコマンドを一切挟まないのが安全です。

@echo off

somecommand.exe
if %ERRORLEVEL% neq 0 (
    echo [ERROR] somecommand に失敗しました (code: %ERRORLEVEL%)
    exit /b %ERRORLEVEL%
)
echo 処理が完了しました

ポイント：ERRORLEVELを変数に退避する方法もあります。set RESULT=%ERRORLEVEL% として保存すれば後からいつでも参照可能です。ただし set 自体がERRORLEVELに影響する場合もあるため、コマンド直後に行いましょう。

@echo off

somecommand.exe

if errorlevel 1 echo エラー発生
if errorlevel 0 echo 正常終了

実行結果（ERRORLEVELが1のとき）

エラー発生
正常終了

@echo off

somecommand.exe

rem 方法1: %ERRORLEVEL% で等号比較
if %ERRORLEVEL% equ 0 (
    echo 正常終了
) else (
    echo エラー発生 (code: %ERRORLEVEL%)
)

rem 方法2: if errorlevel を使うなら降順で判定
if errorlevel 2 echo 致命的エラー
if errorlevel 1 echo 軽微なエラー
if errorlevel 0 echo 正常終了

@echo off

if exist input.txt (
    somecommand.exe input.txt
    echo ERRORLEVEL = %ERRORLEVEL%
    if %ERRORLEVEL% neq 0 (
        echo エラーが発生しました
    )
)

@echo off
setlocal enabledelayedexpansion

if exist input.txt (
    somecommand.exe input.txt
    echo ERRORLEVEL = !ERRORLEVEL!
    if !ERRORLEVEL! neq 0 (
        echo エラーが発生しました
    )
)

遅延展開が必要になるケース

• if / else の括弧ブロック内で変数を参照する場合
• for ループ内で変数の値が変化する場合
• 複合コマンド（&& や || で連結した行）の後半で参照する場合

注意：遅延展開を有効にすると、感嘆符（!）が特殊文字として扱われます。文字列中に ! を含むファイル名やデータを扱う場合は、^! でエスケープする必要があります。

@echo off

rem type が失敗しても find の結果だけが評価される
type data.txt | find "ERROR" > nul
if errorlevel 1 (
    echo エラー文字列が見つかりませんでした
) else (
    echo エラー文字列が見つかりました
)

@echo off

rem まずファイルの存在を確認
if not exist data.txt (
    echo [ERROR] data.txt が見つかりません
    exit /b 1
)

rem ファイルが存在することを確認してから検索
find "ERROR" data.txt > nul 2>&1
if %ERRORLEVEL% equ 0 (
    echo エラー文字列が見つかりました
) else (
    echo エラー文字列は見つかりませんでした
)

ポイント：パイプを使う場合は、前段の処理を事前チェックで切り離すか、一時ファイルに出力してから次の処理を実行するのが安全です。また、リダイレクト（>）でも同様の問題は起きにくいですが、2>&1 で標準エラーもまとめる習慣を付けておくとデバッグが容易です。

@echo off

echo メイン処理開始
goto :DoWork

rem ここは実行されない
echo メイン処理に戻りました
if %ERRORLEVEL% neq 0 echo エラー
exit /b 0

:DoWork
echo サブ処理実行中...
somecommand.exe
exit /b %ERRORLEVEL%

@echo off

echo メイン処理開始
call :DoWork

rem CALLなので、ここに戻ってくる
echo メイン処理に戻りました
if %ERRORLEVEL% neq 0 (
    echo [ERROR] サブルーチンでエラーが発生
    exit /b 1
)
echo すべて正常
exit /b 0

:DoWork
echo サブ処理実行中...
somecommand.exe
exit /b %ERRORLEVEL%

@echo off

somecommand.exe
if %ERRORLEVEL% neq 0 (
    echo エラーが発生しました
    exit 1
)

@echo off

somecommand.exe
if %ERRORLEVEL% neq 0 (
    echo エラーが発生しました
    exit /b 1  rem バッチファイルだけ終了し、呼び出し元に戻る
)

@echo off

set LOGDIR=C:\Program Files\MyApp\logs

rem 空白で分断される
if not exist %LOGDIR% (
    mkdir %LOGDIR%
)

rem copy先も分断される
copy output.log %LOGDIR%\output.log
if %ERRORLEVEL% neq 0 echo コピー失敗

@echo off

set "LOGDIR=C:\Program Files\MyApp\logs"

rem 変数参照時もダブルクォートで囲む
if not exist "%LOGDIR%" (
    mkdir "%LOGDIR%"
    if %ERRORLEVEL% neq 0 (
        echo [ERROR] ディレクトリ作成に失敗
        exit /b 1
    )
)

copy output.log "%LOGDIR%\output.log"
if %ERRORLEVEL% neq 0 echo [ERROR] コピーに失敗

ポイント：set 文でも set "VAR=値" と全体をダブルクォートで囲む書き方が推奨されます。set VAR="値" と書くと、値にダブルクォートが含まれてしまうので注意してください。

@echo off

rem 変数に&が含まれるとコマンド区切りと誤解される
set MSG=処理A&処理B完了
echo %MSG%

rem ファイル名に特殊文字が含まれる場合
copy report(2024).txt backup.txt
if %ERRORLEVEL% neq 0 echo 失敗

@echo off

rem 方法1: ダブルクォートで囲む
set "MSG=処理A&処理B完了"
echo %MSG%

rem 方法2: キャレット（^）でエスケープ
echo 処理A^&処理B完了

rem ファイル名に特殊文字がある場合はダブルクォート
copy "report(2024).txt" backup.txt
if %ERRORLEVEL% neq 0 echo 失敗

@echo off

robocopy C:\source C:\dest /MIR

rem robocopyは正常でも1〜7を返すため、常にエラー扱いになる
if %ERRORLEVEL% neq 0 (
    echo [ERROR] robocopy に失敗しました
    exit /b 1
)
echo 正常に完了しました

@echo off

robocopy C:\source C:\dest /MIR
set RC=%ERRORLEVEL%

rem 8以上がエラー（ビットフラグ）
if %RC% geq 8 (
    echo [ERROR] robocopy に失敗しました (code: %RC%)
    exit /b 1
)

rem 0〜7は正常（情報・警告含む）
echo robocopy 正常完了 (code: %RC%)
exit /b 0

ポイント：robocopy以外にも、xcopy（終了コード 0=正常, 4=コピー先の容量不足）やdsquery、net useなど、コマンドごとに終了コードの意味は異なります。エラー判定を書く前に、そのコマンドの終了コード仕様を確認する習慣をつけましょう。

@echo off

findstr "SUCCESS" result.log > nul
if %ERRORLEVEL% neq 0 (
    echo [ERROR] 処理に失敗しました
    exit /b 1
)

@echo off

rem まずファイルの存在を確認
if not exist result.log (
    echo [ERROR] result.log が見つかりません
    exit /b 2
)

findstr "SUCCESS" result.log > nul 2>&1
if %ERRORLEVEL% equ 0 (
    echo 処理は正常に完了しました
) else if %ERRORLEVEL% equ 1 (
    echo [WARNING] SUCCESS文字列が見つかりません。処理結果を確認してください
) else (
    echo [ERROR] findstr でエラーが発生しました
    exit /b 1
)

@echo off

call :Validate input.txt
if %ERRORLEVEL% neq 0 (
    echo バリデーション失敗
    exit /b 1
)
echo バリデーション成功
exit /b 0

:Validate
if not exist %1 (
    echo ファイルが見つかりません
    rem exit /b を忘れている！
)
echo ファイルを確認しました

@echo off

call :Validate input.txt
if %ERRORLEVEL% neq 0 (
    echo バリデーション失敗
    exit /b 1
)
echo バリデーション成功
exit /b 0

:Validate
if not exist "%~1" (
    echo [ERROR] %~1 が見つかりません
    exit /b 1
)
echo [OK] %~1 を確認しました
exit /b 0

ポイント：サブルーチンを設計するときは、すべての分岐で exit /b 終了コード を明示しましょう。正常時は exit /b 0、エラー時は exit /b 1 以上の値を返します。引数には %~1（チルダ付き）を使うと、渡されたダブルクォートが自動的に除去されます。

@echo off

set INPUT=abc

rem 数値でない文字列を計算しようとする
set /a RESULT=%INPUT% + 10

rem ERRORLEVEL は 0 のままなのでエラーを検出できない
if %ERRORLEVEL% neq 0 (
    echo 計算エラー
) else (
    echo 計算結果: %RESULT%
)

実行結果

計算結果: 10

@echo off

set INPUT=abc

rem 数値かどうかを事前にチェック
echo %INPUT% | findstr /r "^[0-9][0-9]*$" > nul
if %ERRORLEVEL% neq 0 (
    echo [ERROR] 入力値が数値ではありません: %INPUT%
    exit /b 1
)

set /a RESULT=%INPUT% + 10
echo 計算結果: %RESULT%

注意：SET /A はゼロ除算（set /a RESULT=10/0）でも ERRORLEVELを変更しません。標準エラーにメッセージが出力されるだけです。ゼロ除算を検出するには、除数が0でないことを事前にチェックする必要があります。

@echo off

set ERRORS=0

for %%f in (file1.txt file2.txt file3.txt) do (
    copy %%f backup\%%f
    if %ERRORLEVEL% neq 0 (
        echo [ERROR] %%f のコピーに失敗
        set /a ERRORS+=1
    )
)

echo エラー件数: %ERRORS%

@echo off
setlocal enabledelayedexpansion

set ERRORS=0

for %%f in (file1.txt file2.txt file3.txt) do (
    copy %%f backup\%%f > nul 2>&1
    if !ERRORLEVEL! neq 0 (
        echo [ERROR] %%f のコピーに失敗
        set /a ERRORS+=1
    ) else (
        echo [OK] %%f をコピーしました
    )
)

echo エラー件数: !ERRORS!
if !ERRORS! gtr 0 exit /b 1
exit /b 0

ポイント：FORループ内では %変数% ではなく !変数! を使うのが鉄則です。ERRORLEVEL、ループカウンタ、フラグ変数など、ループ内で値が変化するすべての変数に !…! を使いましょう。

@echo off

rem step1.bat がエラーで終了
call step1.bat

rem step2.bat 内でERRORLEVELをチェックすると
rem step1のエラーコードが残っている可能性がある
call step2.bat

@echo off

rem 最初のコマンド実行前に判定すると
rem 前回のERRORLEVELが残っている
echo 処理開始 (ERRORLEVEL=%ERRORLEVEL%)

rem この時点で ERRORLEVEL が 0 でない可能性がある
somecommand.exe

@echo off

echo === Step 1 ===
call step1.bat
if %ERRORLEVEL% neq 0 (
    echo [ERROR] step1 失敗。処理を中断します。
    exit /b 1
)

echo === Step 2 ===
call step2.bat
if %ERRORLEVEL% neq 0 (
    echo [ERROR] step2 失敗。処理を中断します。
    exit /b 1
)

echo すべてのステップが正常に完了しました
exit /b 0

@echo off

rem ERRORLEVELを明示的にリセット
cmd /c "exit /b 0"

rem ここからが本来の処理
somecommand.exe
if %ERRORLEVEL% neq 0 (
    echo [ERROR] 処理に失敗しました
    exit /b 1
)
exit /b 0

ポイント：ERRORLEVELをリセットする方法はいくつかあります。cmd /c "exit /b 0"、ver > nul（ver は常に0を返す）、(call )（空のcall）などが使えます。バッチの先頭でリセットする習慣を付けると安全です。

5つの原則

• 原則1: 即座に判定する ── コマンド実行直後にERRORLEVELをチェック。間に何も挟まない
• 原則2: 遅延展開を理解する ── 括弧ブロック・FORループ内では !ERRORLEVEL! を使う
• 原則3: コマンドの仕様を確認する ── robocopy、findstr、xcopy など、コマンドごとに終了コードの意味が異なる
• 原則4: 戻り値を設計する ── サブルーチンはすべての分岐で exit /b N を明示する
• 原則5: 防御的に書く ── パスはダブルクォートで囲み、特殊文字はエスケープし、入力値を検証する