【bat】バッチファイルでエラーが発生したかを判定する方法 ── ERRORLEVEL・演算子・実務パターンを完全解説

この記事で学べること

• %ERRORLEVEL% と if errorlevel N の違いと使い分け
• ||（失敗時実行）と &&（成功時実行）による条件分岐
• 主要コマンド（robocopy / find / xcopy 等）の終了コード一覧
• 遅延展開（!ERRORLEVEL!）が必要になる場面と書き方
• 実務で使えるエラー判定テンプレート（ファイル操作・DB接続・サービス確認）
• エラーログの出力とローテーション

注意：ERRORLEVELは「エラーレベル」という名前ですが、実際には終了コード（exit code）と呼ぶ方が正確です。0以外の値が必ずしもエラーを意味するわけではないため、「ERRORLEVELが0以外＝エラー」という固定観念は危険です。

@echo off

rem この時点では ERRORLEVEL = 0（初期値）
echo 開始時: %ERRORLEVEL%

rem 存在するファイルをコピー → 成功 → ERRORLEVEL = 0
copy C:\Windows\System32\notepad.exe C:\temp\test.exe >nul 2>&1
echo copy成功後: %ERRORLEVEL%

rem 存在しないファイルをコピー → 失敗 → ERRORLEVEL = 1
copy C:\notexist\dummy.txt C:\temp\ >nul 2>&1
echo copy失敗後: %ERRORLEVEL%

rem echoは常に成功 → ERRORLEVEL = 0 に戻る
echo echoを挟んだ後: %ERRORLEVEL%

実行結果

開始時: 0
copy成功後: 0
copy失敗後: 1
echoを挟んだ後: 0

ポイント：ERRORLEVELは「蓄積」されません。直前のコマンドの結果で毎回上書きされるため、エラー判定は対象コマンドの直後で行うのが鉄則です。間にechoやsetなど別のコマンドを挟むと、そのコマンドの終了コードで上書きされてしまいます。

@echo off

somecommand

rem 等号比較（0と等しい場合）
if %ERRORLEVEL% equ 0 (
    echo 正常終了
)

rem 不等号比較（0以外の場合）
if %ERRORLEVEL% neq 0 (
    echo エラーが発生しました（終了コード: %ERRORLEVEL%）
    exit /b 1
)

rem 特定の値との比較
if %ERRORLEVEL% equ 2 (
    echo 終了コード2が返されました
)

@echo off

somecommand

rem ERRORLEVEL が 1 以上のとき TRUE
if errorlevel 1 (
    echo エラーが発生しました
    exit /b 1
)

rem 複数のコードを判定する場合は大きい値から順に書く
if errorlevel 3 (
    echo 終了コード 3 以上
    exit /b 3
)
if errorlevel 2 (
    echo 終了コード 2
    exit /b 2
)
if errorlevel 1 (
    echo 終了コード 1
    exit /b 1
)

注意：if errorlevel 1 は「ERRORLEVELが1と等しい」ではなく「ERRORLEVELが1以上」という意味です。複数のコードを判定するときは必ず大きい数値から順にチェックする必要があります。

ポイント：実務では if %ERRORLEVEL% neq 0 が最もよく使われます。等号比較が直感的で、特定の終了コードも判定できるためです。ただし、括弧ブロック内で使う場合は遅延展開が必要になる点に注意してください。

@echo off

xcopy C:\source C:\dest /E /I /Y >nul 2>&1

rem 大きい値から順に判定（重要！）
if errorlevel 5 (
    echo [FATAL] ディスク書き込みエラー
    exit /b 5
)
if errorlevel 4 (
    echo [ERROR] メモリ不足またはディスク容量不足
    exit /b 4
)
if errorlevel 2 (
    echo [WARN] Ctrl+C で中断されました
    exit /b 2
)
if errorlevel 1 (
    echo [ERROR] コピー対象のファイルが見つかりません
    exit /b 1
)

echo [OK] コピーが正常に完了しました
exit /b 0

@echo off

rem 3つのコマンドを順に実行。途中で失敗したら停止
mkdir C:\work\output 2>nul && (
    echo [1/3] ディレクトリ作成: OK
) && (
    copy C:\work\data.csv C:\work\output\ >nul
    echo [2/3] ファイルコピー: OK
) && (
    echo [3/3] すべて完了
)

rem 1行で書く場合
mkdir output && copy data.csv output\ && echo 完了

@echo off

rem 失敗時にエラーメッセージを表示して終了
copy source.txt dest.txt >nul 2>&1 || (
    echo [ERROR] ファイルコピーに失敗しました
    exit /b 1
)

rem 1行で書く場合
copy source.txt dest.txt >nul || exit /b 1

rem ping失敗時にエラーログに記録
ping -n 1 example.com >nul 2>&1 || (
    echo %DATE% %TIME% ネットワーク接続に失敗 >> error.log
    exit /b 1
)

@echo off

rem 成功なら「OK」、失敗なら「NG」
ping -n 1 google.com >nul 2>&1 && (
    echo [OK] ネットワーク接続正常
) || (
    echo [NG] ネットワーク接続失敗
)

rem ファイルの存在確認 → コピー → 完了報告
if exist "source.txt" (
    copy source.txt backup\ >nul && echo バックアップ完了 || echo コピー失敗
) else (
    echo コピー元ファイルが存在しません
)

ポイント：|| と && は、if %ERRORLEVEL% を使うよりも簡潔にエラー処理を書けます。ただし、複雑な分岐や特定の終了コード値による判定が必要な場合は %ERRORLEVEL% を使う方が適切です。用途に応じて使い分けましょう。

注意：find / findstr の ERRORLEVEL=1 は「見つからなかった」であり、エラーではありません。if %ERRORLEVEL% neq 0 で一律エラー扱いすると、正常な「不一致」をエラーとして誤検知してしまいます。

注意：robocopyは0〜7が正常、8以上がエラーです。if %ERRORLEVEL% neq 0 で判定すると、正常なコピー（ERRORLEVEL=1）をエラーとして扱ってしまう重大なバグになります。robocopyのエラー判定は if %ERRORLEVEL% geq 8 とする必要があります。

@echo off

robocopy C:\source C:\dest /MIR /R:3 /W:5
set RC=%ERRORLEVEL%

rem robocopyは 0〜7 が正常、8以上がエラー
if %RC% geq 8 (
    echo [ERROR] robocopy失敗（終了コード: %RC%）
    exit /b 1
)

rem 正常終了（0〜7の詳細を出し分けたい場合）
if %RC% equ 0 echo [INFO] 変更なし
if %RC% equ 1 echo [OK] コピー完了
if %RC% geq 2 if %RC% leq 7 echo [OK] コピー完了（追加情報あり: %RC%）

exit /b 0

@echo off

if 1==1 (
    rem このブロック全体が「解析時」に%ERRORLEVEL%を展開
    copy notexist.txt dest.txt >nul 2>&1
    echo ERRORLEVEL = %ERRORLEVEL%
    rem ↑ copyが失敗しても 0 と表示される場合がある
)

@echo off
setlocal enabledelayedexpansion

if 1==1 (
    copy notexist.txt dest.txt >nul 2>&1
    echo ERRORLEVEL = !ERRORLEVEL!
    rem ↑ 正しく 1 と表示される
)

実行結果

ERRORLEVEL = 1

@echo off
setlocal enabledelayedexpansion

set ERROR_COUNT=0

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

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

@echo off

rem 遅延展開なしでもOK
for %%F in (file1.txt file2.txt file3.txt) do (
    copy %%F backup\ >nul 2>&1
    if errorlevel 1 (
        echo [ERROR] %%F のコピーに失敗
    ) else (
        echo [OK] %%F のコピーに成功
    )
)

@echo off

rem typeが失敗しても、findが成功すればERRORLEVEL=0
type notexist.txt | find "ABC"
echo ERRORLEVEL = %ERRORLEVEL%
rem ↑ typeの失敗は検知できない

@echo off

rem ステップ1: ファイル読み取りの確認
type sample.txt >nul 2>&1
if %ERRORLEVEL% neq 0 (
    echo [ERROR] ファイルの読み取りに失敗しました
    exit /b 1
)

rem ステップ2: 検索の実行
find "ABC" sample.txt >nul
if %ERRORLEVEL% equ 0 (
    echo 見つかりました
) else if %ERRORLEVEL% equ 1 (
    echo 見つかりませんでした
) else (
    echo [ERROR] 検索処理でエラーが発生しました
    exit /b 2
)

@echo off

rem サブルーチンの呼び出しと戻り値の判定
call :check_file "C:\data\input.csv"
if %ERRORLEVEL% neq 0 (
    echo ファイルチェックに失敗しました
    exit /b 1
)

call :process_file "C:\data\input.csv"
if %ERRORLEVEL% neq 0 (
    echo ファイル処理に失敗しました
    exit /b 1
)

echo すべての処理が完了しました
exit /b 0

rem ===== サブルーチン =====

:check_file
if not exist %~1 (
    echo [ERROR] ファイルが見つかりません: %~1
    exit /b 1
)
echo [OK] ファイル存在確認: %~1
exit /b 0

:process_file
echo 処理中: %~1
rem 何らかの処理...
findstr "ERROR" %~1 >nul 2>&1
if %ERRORLEVEL% equ 0 (
    echo [WARN] ファイルにエラーが含まれています
    exit /b 2
)
exit /b 0

注意：exit /b と exit は異なります。exit（/bなし）はcmd.exeそのものを終了させるため、バッチファイルの呼び出し元や、タスクスケジューラから起動された場合にウィンドウが閉じてしまいます。サブルーチンからの戻りには必ず exit /b を使いましょう。

@echo off
setlocal

set SRC=C:\data\daily_report.csv
set DST=D:\backup\daily_report_%DATE:~0,4%%DATE:~5,2%%DATE:~8,2%.csv

rem コピー元の存在確認
if not exist "%SRC%" (
    echo [ERROR] コピー元ファイルが存在しません: %SRC%
    exit /b 1
)

rem コピー先ディレクトリの確認・作成
if not exist "D:\backup" (
    mkdir "D:\backup"
    if %ERRORLEVEL% neq 0 (
        echo [ERROR] バックアップディレクトリの作成に失敗
        exit /b 1
    )
)

rem ファイルコピーの実行
copy /Y "%SRC%" "%DST%" >nul
if %ERRORLEVEL% neq 0 (
    echo [ERROR] ファイルコピーに失敗: %SRC% → %DST%
    exit /b 1
)

rem コピー結果の検証
if not exist "%DST%" (
    echo [ERROR] コピー先にファイルが存在しません
    exit /b 1
)

echo [OK] バックアップ完了: %DST%
exit /b 0

@echo off
setlocal

set SRC=C:\project\release
set DST=\\server\share\deploy
set LOG=C:\logs\robocopy_%DATE:~0,4%%DATE:~5,2%%DATE:~8,2%.log

robocopy "%SRC%" "%DST%" /MIR /R:3 /W:10 /LOG:"%LOG%" /NP
set RC=%ERRORLEVEL%

rem robocopy: 0〜7=正常、8以上=エラー
if %RC% geq 8 (
    echo [ERROR] robocopy失敗 コード:%RC% ログ:%LOG%
    exit /b 1
)
if %RC% equ 0 (
    echo [INFO] 変更なし
) else (
    echo [OK] 同期完了（コード:%RC%）
)
exit /b 0

@echo off
setlocal enabledelayedexpansion

set TARGETS=dbserver fileserver webserver
set FAIL_COUNT=0

for %%H in (%TARGETS%) do (
    ping -n 1 -w 3000 %%H >nul 2>&1
    if !ERRORLEVEL! neq 0 (
        echo [NG] %%H に接続できません
        set /a FAIL_COUNT+=1
    ) else (
        echo [OK] %%H 接続確認
    )
)

if !FAIL_COUNT! gtr 0 (
    echo [ERROR] !FAIL_COUNT! 台のサーバーに接続できませんでした
    exit /b 1
)
echo [OK] すべてのサーバーに接続確認完了
exit /b 0

@echo off
setlocal

set SERVICE_NAME=MySQL80

rem サービスの存在確認
sc query %SERVICE_NAME% >nul 2>&1
if %ERRORLEVEL% equ 1060 (
    echo [ERROR] サービス %SERVICE_NAME% は存在しません
    exit /b 1
)

rem サービスの状態確認（RUNNINGかどうか）
sc query %SERVICE_NAME% | findstr "RUNNING" >nul
if %ERRORLEVEL% neq 0 (
    echo [WARN] %SERVICE_NAME% が停止しています。起動を試みます...
    net start %SERVICE_NAME%
    if %ERRORLEVEL% neq 0 (
        echo [ERROR] %SERVICE_NAME% の起動に失敗しました
        exit /b 1
    )
    echo [OK] %SERVICE_NAME% を起動しました
) else (
    echo [OK] %SERVICE_NAME% は正常に稼働中です
)
exit /b 0

@echo off
setlocal

set DB_SERVER=localhost\SQLEXPRESS
set DB_NAME=MyDatabase
set MAX_RETRY=3
set RETRY_WAIT=5

for /L %%I in (1,1,%MAX_RETRY%) do (
    echo 接続試行 %%I/%MAX_RETRY% ...
    sqlcmd -S %DB_SERVER% -d %DB_NAME% -Q "SELECT 1" -h -1 >nul 2>&1
    if !ERRORLEVEL! equ 0 (
        echo [OK] データベース接続成功
        exit /b 0
    )
    echo [WARN] 接続失敗。%RETRY_WAIT%秒後にリトライ...
    timeout /t %RETRY_WAIT% /nobreak >nul
)

echo [ERROR] %MAX_RETRY%回の試行後もDB接続に失敗しました
exit /b 1

ポイント：DB接続やネットワーク系の処理は、一時的な障害で失敗することがあるためリトライ機能を組み込むのが実務の定石です。上記のように for /L とtimeoutを組み合わせれば、指定回数のリトライを簡単に実装できます。

@echo off
setlocal enabledelayedexpansion

set TOTAL=0
set SUCCESS=0
set FAIL=0

rem --- タスク1: ファイルコピー ---
set /a TOTAL+=1
copy data.csv backup\ >nul 2>&1
if !ERRORLEVEL! equ 0 (
    echo [OK] タスク1: ファイルコピー
    set /a SUCCESS+=1
) else (
    echo [NG] タスク1: ファイルコピー
    set /a FAIL+=1
)

rem --- タスク2: ログクリーンアップ ---
set /a TOTAL+=1
forfiles /P C:\logs /M *.log /D -30 /C "cmd /c del @path" 2>nul
if !ERRORLEVEL! leq 1 (
    echo [OK] タスク2: ログクリーンアップ
    set /a SUCCESS+=1
) else (
    echo [NG] タスク2: ログクリーンアップ
    set /a FAIL+=1
)

rem --- タスク3: レポート生成 ---
set /a TOTAL+=1
cscript //nologo generate_report.vbs
if !ERRORLEVEL! equ 0 (
    echo [OK] タスク3: レポート生成
    set /a SUCCESS+=1
) else (
    echo [NG] タスク3: レポート生成
    set /a FAIL+=1
)

rem --- 結果サマリー ---
echo ========================================
echo   実行結果: !SUCCESS!/!TOTAL! 成功, !FAIL! 失敗
echo ========================================

if !FAIL! gtr 0 exit /b 1
exit /b 0

@echo off
setlocal

set LOG_FILE=C:\logs\batch_%DATE:~0,4%%DATE:~5,2%%DATE:~8,2%.log

rem ログ出力用のサブルーチンを定義
call :log INFO "バッチ処理を開始します"

copy data.csv backup\ >nul 2>&1
if %ERRORLEVEL% neq 0 (
    call :log ERROR "ファイルコピーに失敗（code: %ERRORLEVEL%）"
    exit /b 1
)
call :log INFO "ファイルコピー完了"

call :log INFO "バッチ処理が正常に完了しました"
exit /b 0

:log
set LEVEL=%~1
set MSG=%~2
echo %DATE% %TIME% [%LEVEL%] %MSG%
echo %DATE% %TIME% [%LEVEL%] %MSG% >> "%LOG_FILE%"
exit /b 0

ログ出力例

2026/03/06 10:30:15.42 [INFO] バッチ処理を開始します
2026/03/06 10:30:15.89 [INFO] ファイルコピー完了
2026/03/06 10:30:16.01 [INFO] バッチ処理が正常に完了しました

@echo off

rem 通常出力は output.log、エラーは error.log に分離
robocopy C:\src C:\dst /MIR > output.log 2> error.log

rem 全出力をまとめて1つのログファイルに記録
robocopy C:\src C:\dst /MIR >> all.log 2>&1

@echo off

rem 30日以上前の.logファイルを削除
forfiles /P C:\logs /M *.log /D -30 /C "cmd /c echo 削除: @path && del @path" 2>nul

rem forfilesは対象ファイルがない場合もERRORLEVEL=1を返す
rem そのためエラー判定は不要（対象なし＝正常）

copy notexist.txt dest.txt
echo コピー処理が終わりました   rem ← これでERRORLEVELが0になる
if %ERRORLEVEL% neq 0 echo エラー  rem ← 検知できない

rem 方法1: 判定を先にする
copy notexist.txt dest.txt
if %ERRORLEVEL% neq 0 (
    echo [ERROR] コピー失敗
    exit /b 1
)
echo コピー完了

rem 方法2: 変数に保存する
copy notexist.txt dest.txt
set COPY_RESULT=%ERRORLEVEL%
echo コピー処理が終わりました
if %COPY_RESULT% neq 0 (
    echo [ERROR] コピー失敗（code: %COPY_RESULT%）
    exit /b 1
)

rem これをやると以降の%ERRORLEVEL%が常に0になる
set ERRORLEVEL=0    rem ← 絶対にやってはいけない

rem 修正するには値なしでsetする
set ERRORLEVEL=      rem ← ユーザー定義を削除してシステム値に戻す

rem ERRORLEVELが3の場合、「1以上」に一致してしまう
if errorlevel 1 echo コード1  rem ← 3でもここに入る
if errorlevel 2 echo コード2
if errorlevel 3 echo コード3  rem ← ここには到達しない

rem 方法1: 必ず成功するコマンドを実行する
ver >nul    rem ver は常にERRORLEVEL=0を返す

rem 方法2: cmd /c exit 0 を実行する
cmd /c "exit /b 0"

rem NG: これはユーザー変数を定義するだけ
rem set ERRORLEVEL=0  ← やってはいけない

@echo off
setlocal enabledelayedexpansion

rem ===== 設定 =====
set SCRIPT_NAME=%~n0
set LOG_DIR=C:\logs
set LOG_FILE=%LOG_DIR%\%SCRIPT_NAME%_%DATE:~0,4%%DATE:~5,2%%DATE:~8,2%.log
set EXIT_CODE=0

rem ===== ログディレクトリの確認 =====
if not exist "%LOG_DIR%" mkdir "%LOG_DIR%"

call :log INFO "%SCRIPT_NAME% 開始"

rem ===== メイン処理 =====
call :task1 || goto :error_exit
call :task2 || goto :error_exit
call :task3 || goto :error_exit

rem ===== 正常終了 =====
call :log INFO "%SCRIPT_NAME% 正常終了"
exit /b 0

rem ===== エラー終了 =====
:error_exit
set EXIT_CODE=%ERRORLEVEL%
call :log ERROR "%SCRIPT_NAME% 異常終了（code: !EXIT_CODE!）"
exit /b !EXIT_CODE!

rem ===== サブルーチン =====
:task1
call :log INFO "タスク1: ファイルバックアップ開始"
copy /Y data.csv backup\ >nul 2>&1
if !ERRORLEVEL! neq 0 (
    call :log ERROR "タスク1: ファイルバックアップ失敗"
    exit /b 1
)
call :log INFO "タスク1: 完了"
exit /b 0

:task2
call :log INFO "タスク2: データ処理開始"
rem 処理内容をここに記述...
call :log INFO "タスク2: 完了"
exit /b 0

:task3
call :log INFO "タスク3: レポート送信開始"
rem 処理内容をここに記述...
call :log INFO "タスク3: 完了"
exit /b 0

:log
set _LV=%~1
set _MSG=%~2
echo %DATE% %TIME% [%_LV%] %_MSG%
echo %DATE% %TIME% [%_LV%] %_MSG% >> "%LOG_FILE%"
exit /b 0

ポイント：このテンプレートには3つの重要な設計が含まれています。(1) call :task || goto :error_exit で失敗時に即座にエラー終了、(2) ログ出力サブルーチンによる一貫したログ記録、(3) 各サブルーチンで明示的に exit /b 0 または exit /b 1 を返す戻り値設計です。

この記事のまとめ

• ERRORLEVELは直前のコマンドの終了コードで上書きされる。蓄積はされない
• %ERRORLEVEL% は等号比較が可能だが、括弧ブロック内では遅延展開（!ERRORLEVEL!）が必要
• if errorlevel N は「N以上」の判定。大きい値から順にチェックする
• ||（失敗時実行）と &&（成功時実行）で簡潔なエラー処理が可能
• robocopyは0〜7が正常、find/findstrは1が「見つからない」。コマンドごとに終了コードの意味が異なる
• エラー判定は対象コマンドの直後で行う。echoやsetを挟まない
• set ERRORLEVEL=値 はシステム値を破壊するので絶対にやらない
• サブルーチンでは exit /b N で明示的に戻り値を返す