【bat】エラー時に処理を中断・終了する方法｜EXIT /B・ERRORLEVEL・実務パターンまで完全解説

この記事で学べること

• ERRORLEVELを使ったエラー判定と中断の基本パターン
• exit /b と exit の違いと使い分け
• || 演算子による簡潔なエラー処理
• サブルーチンでのエラー伝播の設計
• 遅延環境変数展開が必要な場面と対処法
• パイプ処理でのエラー検知の注意点
• ログ出力付きエラーハンドリングの実装
• デプロイ・バックアップスクリプトでの実務的な活用例
• よくあるミスとトラブルシューティング

注意：if errorlevel 1 は「ERRORLEVELが1以上」を意味します。「1に等しい」ではありません。この仕様を誤解すると、意図しない判定結果になります。

ポイント：echo や set はERRORLEVELを変更しないため、これらをエラー判定の前に挟んでも問題ありません。ただし混乱を避けるため、判定は対象コマンドの直後に行うのが望ましいです。

REM エラー時に中断する基本形
@echo off

REM コマンドを実行
copy source.txt dest.txt
if %ERRORLEVEL% neq 0 (
  echo エラー: ファイルのコピーに失敗しました
  exit /b 1
)

REM コピー成功後の処理
echo ファイルのコピーが完了しました
exit /b 0

ポイント：ERRORLEVELの判定は、必ず対象コマンドの直後に行います。間に別のコマンドを挟むと、ERRORLEVELがそのコマンドの結果で上書きされてしまいます。

ポイント：正常終了時にも exit /b 0 を明示的に書くことで、戻り値が不定にならず安全です。

@echo off

REM ステップ1: ディレクトリ作成
mkdir output
if %ERRORLEVEL% neq 0 (
  echo エラー: ディレクトリの作成に失敗しました
  exit /b 1
)

REM ステップ2: ファイルコピー
copy data.csv output\data.csv
if %ERRORLEVEL% neq 0 (
  echo エラー: ファイルのコピーに失敗しました
  exit /b 2
)

REM ステップ3: 処理実行
call process.bat output\data.csv
if %ERRORLEVEL% neq 0 (
  echo エラー: データ処理に失敗しました
  exit /b 3
)

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

実行結果（ステップ2で失敗した場合）

エラー: ファイルのコピーに失敗しました

@echo off
echo 処理を開始します

somecommand
if %ERRORLEVEL% neq 0 (
  echo エラーが発生しました。中断します。
  exit /b 1
)

echo 処理が正常に完了しました
exit /b 0

@echo off
REM タスクスケジューラから実行されるバッチ

call backup.bat
if %ERRORLEVEL% neq 0 (
  echo バックアップ失敗 >> error.log
  exit 1
)
exit 0

注意：対話的なコマンドプロンプトで exit（/b なし）を実行すると、ウィンドウが閉じてしまいます。手動実行するバッチでは必ず exit /b を使ってください。

@echo off

if not exist config.ini (
  echo 設定ファイルが見つかりません
  goto :eof
)

REM 設定ファイルが存在する場合の処理
echo 設定を読み込みます

ポイント：エラー時に戻り値を返す必要がある場合は exit /b N を使い、単に処理を中断するだけなら goto :eof も使えます。実務では戻り値を明示する exit /b を推奨します。

REM 基本構文: コマンド || エラー時の処理
copy source.txt dest.txt || exit /b 1

REM メッセージ付き
copy source.txt dest.txt || (echo コピー失敗 & exit /b 1)

@echo off

REM 成功なら次へ、失敗なら中断
copy source.txt dest.txt && echo コピー成功 || (echo コピー失敗 & exit /b 1)

REM 連続実行（すべて成功する必要がある）
mkdir output && copy data.csv output\ && echo 準備完了 || (echo 準備失敗 & exit /b 1)

注意：|| は ERRORLEVELではなく、コマンドの「成功/失敗」を判定します。一部の内部コマンド（set など）は失敗しても || の右辺が実行されないことがあります。確実にエラーを捕捉したい場合は if %ERRORLEVEL% neq 0 を使ってください。

REM ERRORLEVEL が 1 以上（= エラー）なら中断
somecommand
if errorlevel 1 (
  echo エラーが発生しました
  exit /b 1
)

somecommand

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
)

echo 正常終了（コード0）

注意：小さい値から判定すると、例えばERRORLEVELが3でも if errorlevel 1 がtrue になってしまい、正確な分岐ができません。

@echo off

copy source.txt dest.txt

REM 正常時のみ次の処理を実行
if NOT errorlevel 1 (
  echo コピー成功。次の処理へ進みます
  call next-step.bat
) else (
  echo コピー失敗。処理を中断します
  exit /b 1
)

@echo off

call :validate_input
if %ERRORLEVEL% neq 0 (
  echo 入力検証でエラーが発生しました
  exit /b 1
)

call :process_data
if %ERRORLEVEL% neq 0 (
  echo データ処理でエラーが発生しました
  exit /b 2
)

echo 全処理が正常に完了しました
exit /b 0

:validate_input
if not exist input.csv (
  echo 入力ファイルが存在しません
  exit /b 1
)
exit /b 0

:process_data
copy input.csv output.csv
if %ERRORLEVEL% neq 0 exit /b 1
exit /b 0

ポイント：サブルーチン内で exit /b を使うと、サブルーチンからのみ抜けて呼び出し元に戻ります。呼び出し元で ERRORLEVEL を判定し、必要に応じてスクリプト全体を終了します。

@echo off

REM 各ステップを順番に実行
call :step1 || goto :error
call :step2 || goto :error
call :step3 || goto :error

echo 全ステップ完了
exit /b 0

:error
echo エラーが発生しました（コード: %ERRORLEVEL%）
exit /b 1

:step1
echo ステップ1を実行中...
mkdir output 2>nul
exit /b 0

:step2
echo ステップ2を実行中...
copy data.csv output\
exit /b %ERRORLEVEL%

:step3
echo ステップ3を実行中...
call process.bat output\data.csv
exit /b %ERRORLEVEL%

@echo off

REM 外部バッチを呼び出し
call C:\scripts\validate.bat %1
if %ERRORLEVEL% neq 0 (
  echo validate.bat がエラーを返しました
  exit /b %ERRORLEVEL%
)

REM 注意: call なしで実行すると制御が戻ってこない
REM C:\scripts\validate.bat %1   ← これだと後続処理が実行されない

注意：外部バッチファイルを call なしで実行すると、呼び出し先のバッチが終了した時点でスクリプト全体が終了します。後続処理やエラー判定を行いたい場合は必ず call を付けてください。

@echo off

REM このコードは正しく動かない場合がある
for %%f in (file1.txt file2.txt file3.txt) do (
  copy %%f backup\
  if %ERRORLEVEL% neq 0 (
    REM ← この判定はブロック先頭の値を見ている
    echo %%f のコピーに失敗
    exit /b 1
  )
)

@echo off
setlocal enabledelayedexpansion

for %%f in (file1.txt file2.txt file3.txt) do (
  copy %%f backup\
  if !ERRORLEVEL! neq 0 (
    echo %%f のコピーに失敗しました
    exit /b 1
  )
)

echo すべてのファイルのコピーが完了しました
endlocal
exit /b 0

@echo off

for %%f in (file1.txt file2.txt file3.txt) do (
  copy %%f backup\ || (
    echo %%f のコピーに失敗
    exit /b 1
  )
)

REM type が失敗しても find が成功すれば ERRORLEVEL は 0
type nonexistent.txt | find "keyword"
echo ERRORLEVEL: %ERRORLEVEL%
REM → ERRORLEVEL: 1（findが一致なしのため）
REM   ※ type の失敗は検知できない

@echo off

REM ステップ1: ファイル存在確認
if not exist data.txt (
  echo ファイルが見つかりません
  exit /b 1
)

REM ステップ2: ファイル読み取りテスト
type data.txt > nul 2>&1
if %ERRORLEVEL% neq 0 (
  echo ファイルの読み取りに失敗
  exit /b 2
)

REM ステップ3: 検索実行
findstr "keyword" data.txt > nul
if %ERRORLEVEL% neq 0 (
  echo キーワードが見つかりません
  exit /b 3
)

echo キーワードが見つかりました

@echo off
set TMPFILE=%TEMP%\pipe_tmp_%RANDOM%.txt

REM 前段の出力を一時ファイルに保存
type data.txt > %TMPFILE%
if %ERRORLEVEL% neq 0 (
  echo 前段処理失敗
  del %TMPFILE% 2>nul
  exit /b 1
)

REM 後段の処理
findstr "keyword" %TMPFILE%
set RESULT=%ERRORLEVEL%
del %TMPFILE% 2>nul

if %RESULT% neq 0 (
  echo 後段処理失敗
  exit /b 2
)

@echo off
set LOGFILE=C:\logs\batch_%date:~0,4%%date:~5,2%%date:~8,2%.log

REM ログ出力サブルーチン
call :log "処理を開始します"

copy source.txt dest.txt
if %ERRORLEVEL% neq 0 (
  call :log "ERROR: ファイルコピー失敗（code: %ERRORLEVEL%）"
  exit /b 1
)
call :log "ファイルコピー完了"

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

:log
echo [%date% %time%] %~1
echo [%date% %time%] %~1 >> %LOGFILE%
exit /b 0

ログ出力例

[2026/03/06 14:30:15.42] 処理を開始します
[2026/03/06 14:30:15.48] ファイルコピー完了
[2026/03/06 14:30:15.50] 処理が正常に完了しました

@echo off
set LOGFILE=C:\logs\app.log

REM INFO レベル
call :log_info "バックアップを開始します"

xcopy C:\data C:\backup\ /E /Y
if %ERRORLEVEL% neq 0 (
  call :log_error "バックアップ失敗（code: %ERRORLEVEL%）"
  exit /b 1
)
call :log_info "バックアップ完了"
exit /b 0

:log_info
echo [%date% %time%] [INFO] %~1 >> %LOGFILE%
exit /b 0

:log_warn
echo [%date% %time%] [WARN] %~1 >> %LOGFILE%
exit /b 0

:log_error
echo [%date% %time%] [ERROR] %~1 >> %LOGFILE%
echo [%date% %time%] [ERROR] %~1 >&2
exit /b 0

ポイント：ERROR レベルのログは標準エラー出力（>&2）にも出力しておくと、タスクスケジューラやCI/CDツールでのエラー検知に役立ちます。

@echo off
setlocal
set DEPLOY_DIR=C:\inetpub\wwwroot\myapp
set BACKUP_DIR=C:\backup\myapp_%date:~0,4%%date:~5,2%%date:~8,2%
set SOURCE_DIR=C:\release\myapp
set LOGFILE=C:\logs\deploy.log

call :log "=== デプロイ開始 ==="

REM ステップ1: ソースの存在確認
if not exist %SOURCE_DIR%\ (
  call :log "ERROR: ソースディレクトリが見つかりません"
  exit /b 1
)

REM ステップ2: 現在のファイルをバックアップ
call :log "バックアップ作成中..."
xcopy %DEPLOY_DIR% %BACKUP_DIR%\ /E /I /Y > nul
if %ERRORLEVEL% neq 0 (
  call :log "ERROR: バックアップの作成に失敗"
  exit /b 2
)

REM ステップ3: 新しいファイルをデプロイ
call :log "デプロイ中..."
xcopy %SOURCE_DIR% %DEPLOY_DIR%\ /E /Y > nul
if %ERRORLEVEL% neq 0 (
  call :log "ERROR: デプロイ失敗。ロールバックします"
  call :rollback
  exit /b 3
)

call :log "=== デプロイ完了 ==="
exit /b 0

:rollback
call :log "ロールバック実行中..."
xcopy %BACKUP_DIR% %DEPLOY_DIR%\ /E /Y > nul
if %ERRORLEVEL% neq 0 (
  call :log "FATAL: ロールバックにも失敗しました"
)
exit /b 0

:log
echo [%date% %time%] %~1
echo [%date% %time%] %~1 >> %LOGFILE%
exit /b 0

正常時の実行結果

[2026/03/06 10:00:00.00] === デプロイ開始 ===
[2026/03/06 10:00:01.23] バックアップ作成中...
[2026/03/06 10:00:05.67] デプロイ中...
[2026/03/06 10:00:08.90] === デプロイ完了 ===

@echo off
setlocal enabledelayedexpansion
set SRC=C:\important-data
set DST=D:\backup\%date:~0,4%%date:~5,2%%date:~8,2%
set LOGFILE=D:\backup\backup.log
set KEEP_DAYS=30
set EXIT_CODE=0

call :log "=== バックアップ開始 ==="

REM ソースディレクトリの確認
if not exist %SRC%\ (
  call :log "ERROR: ソースが見つかりません: %SRC%"
  exit /b 1
)

REM バックアップ先ディレクトリの作成
mkdir %DST% 2>nul
if not exist %DST%\ (
  call :log "ERROR: バックアップ先を作成できません"
  exit /b 2
)

REM バックアップ実行
xcopy %SRC% %DST%\ /E /I /Y /Q
if !ERRORLEVEL! neq 0 (
  call :log "ERROR: バックアップ失敗"
  set EXIT_CODE=3
  goto :cleanup
)
call :log "バックアップ完了: %DST%"

REM 古いバックアップの削除
call :log "%KEEP_DAYS%日以上前のバックアップを削除中..."
forfiles /P D:\backup /D -%KEEP_DAYS% /C "cmd /c if @isdir==TRUE rd /s /q @path" 2>nul

:cleanup
call :log "=== バックアップ終了（code: %EXIT_CODE%）==="
endlocal & exit /b %EXIT_CODE%

:log
echo [%date% %time%] %~1
echo [%date% %time%] %~1 >> %LOGFILE%
exit /b 0

@echo off
setlocal

echo === ビルド開始 ===

REM 1. 依存関係のインストール
echo [1/4] 依存関係をインストール中...
npm install
if %ERRORLEVEL% neq 0 (
  echo ERROR: npm install 失敗
  exit /b 1
)

REM 2. Lint チェック
echo [2/4] Lintチェック中...
npm run lint
if %ERRORLEVEL% neq 0 (
  echo ERROR: Lint エラーがあります
  exit /b 2
)

REM 3. テスト実行
echo [3/4] テスト実行中...
npm test
if %ERRORLEVEL% neq 0 (
  echo ERROR: テスト失敗
  exit /b 3
)

REM 4. ビルド
echo [4/4] ビルド中...
npm run build
if %ERRORLEVEL% neq 0 (
  echo ERROR: ビルド失敗
  exit /b 4
)

echo === ビルド成功 ===
exit /b 0

@echo off

call process.bat input.csv
set RC=%ERRORLEVEL%

if %RC% equ 0 echo 正常終了
if %RC% equ 1 echo 引数エラー: 入力を確認してください
if %RC% equ 2 echo ファイルエラー: ファイルが見つかりません
if %RC% equ 3 echo 処理エラー: 実行中に問題が発生
if %RC% gtr 3 echo 想定外のエラー（code: %RC%）

exit /b %RC%

ポイント：ERRORLEVELの値を変数（%RC%）に退避しておくと、後続のコマンド実行でERRORLEVELが上書きされても元の値を参照できます。

REM NG: echoは問題ないが、他のコマンドだとERRORLEVELが変わる
copy source.txt dest.txt
dir output\   ← ここでERRORLEVELが上書きされる
if %ERRORLEVEL% neq 0 (
  echo copyのエラー？ いいえ、dirの結果です
)

copy source.txt dest.txt
if %ERRORLEVEL% neq 0 (
  echo コピーに失敗しました
  exit /b 1
)
dir output\

REM NG: sub.bat の終了後、ここに戻ってこない
sub.bat
echo この行は実行されない

REM OK: call で呼ぶと制御が戻る
call sub.bat
if %ERRORLEVEL% neq 0 exit /b 1
echo sub.bat が成功しました

REM NG: ブロック内で値が固定される
for %%f in (a.txt b.txt) do (
  copy %%f backup\
  if %ERRORLEVEL% neq 0 echo 失敗
)

setlocal enabledelayedexpansion
for %%f in (a.txt b.txt) do (
  copy %%f backup\
  if !ERRORLEVEL! neq 0 echo %%f のコピー失敗
)

REM NG: ERRORLEVEL=3 でも「エラー1」になる
if errorlevel 1 echo エラー1
if errorlevel 2 echo エラー2
if errorlevel 3 echo エラー3

REM OK: 大きい値から判定する
if errorlevel 3 (
  echo エラー3
  exit /b 3
)
if errorlevel 2 (
  echo エラー2
  exit /b 2
)
if errorlevel 1 (
  echo エラー1
  exit /b 1
)

ポイント：迷ったら exit /b を使ってください。exit（/b なし）が必要な場面は、タスクスケジューラやCI環境からの実行など、限られたケースだけです。

この記事のまとめ

• ERRORLEVEL は直前のコマンドの終了コードを保持する。判定は直後に行う
• exit /b N で現在のバッチから抜ける。exit N はcmd.exeごと終了する
• || 演算子で「失敗したら中断」を1行で書ける
• サブルーチンでは exit /b で終了コードを返し、呼び出し元で判定する
• 括弧ブロック内では遅延展開（!ERRORLEVEL!）を使うか、|| で代替する
• パイプでは最後のコマンドのERRORLEVELしか取得できない。処理を分解して個別に判定する
• 実務ではログ出力・エラーコード設計・ロールバック機構を組み合わせる