【bat】ERRORLEVEL以外でエラーを検知する10の方法｜実務で使えるエラーハンドリング完全ガイド

この記事で学べること

• || 演算子と && 演算子によるエラー検知
• 標準エラー出力のリダイレクトを活用した検知方法
• ファイル・ディレクトリの存在チェックによる判定
• ログファイルの内容解析（FIND / FINDSTR）
• 環境変数・レジストリの変化を利用した検知
• FOR コマンドによる出力パースとバリデーション
• WMIC / PowerShell との連携による高度なエラー検知
• 複数手法を組み合わせた実務向けエラーハンドリング設計

rem コマンドが失敗した場合にのみ echo が実行される
copy source.txt dest.txt || echo コピーに失敗しました

rem 失敗時にエラーコードを返して終了
mkdir output_dir || (echo ディレクトリ作成失敗 & exit /b 1)

@echo off
setlocal

rem ファイルのコピー（失敗時はログ出力して終了）
copy /Y "C:\data\input.csv" "D:\backup\input.csv" || (
    echo [%date% %time%] ERROR: ファイルコピー失敗 >> error.log
    exit /b 1
)

rem ネットワークドライブの接続確認
net use Z: \\server\share || (
    echo ネットワークドライブに接続できません
    exit /b 2
)

rem サービスの起動確認
net start "MySQL" || (
    echo MySQL サービスの起動に失敗しました
    exit /b 3
)

注意：|| 演算子は内部コマンド（SET, ECHO など）の一部では期待通り動作しない場合があります。SET コマンドが変数名を誤って指定しても ERRORLEVEL は変わらず、|| は実行されません。

rem コマンド1が成功した場合のみコマンド2を実行
mkdir output_dir && echo ディレクトリ作成成功

rem 複数コマンドの連鎖
cd /d "C:\project" && git pull && echo 更新完了

rem 成功なら「OK」、失敗なら「NG」を表示
ping -n 1 google.com > nul && (
    echo ネットワーク接続: OK
) || (
    echo ネットワーク接続: NG
    exit /b 1
)

実行結果（ネットワーク接続成功時）

ネットワーク接続: OK

@echo off
setlocal

echo ===== デプロイ開始 =====

rem Step1: ビルド → Step2: テスト → Step3: デプロイ
call build.bat && (
    echo [Step1] ビルド成功
    call test.bat && (
        echo [Step2] テスト成功
        call deploy.bat && (
            echo [Step3] デプロイ成功
        ) || echo [Step3] デプロイ失敗
    ) || echo [Step2] テスト失敗
) || echo [Step1] ビルド失敗

ポイント：&& の連鎖では、途中で失敗すると以降のステップがすべてスキップされます。これにより「ビルド失敗なのにデプロイが実行される」という事故を防げます。

@echo off
setlocal

rem stderr をファイルに出力
somecommand 2> error.log

rem ファイルサイズで stderr の有無を判定
for %%A in (error.log) do if %%~zA neq 0 (
    echo 標準エラー出力が検出されました
    type error.log
    exit /b 1
)

echo 正常終了

%%~zA の意味

• %%~zA は FOR 変数 %%A のファイルサイズ（バイト数）を返す修飾子です
• ファイルが空（0バイト）なら stderr への出力がなかったと判断できます
• この構文はバッチファイル内でのみ有効です（コマンドプロンプトでは %~zA）

@echo off
setlocal

rem stdout → result.log, stderr → error.log
somecommand > result.log 2> error.log

rem stderr が空でなければエラー
for %%A in (error.log) do if %%~zA neq 0 (
    echo [ERROR] 以下のエラーが発生しました:
    type error.log
    exit /b 1
)

rem stdout の内容を処理
echo 処理結果:
type result.log

@echo off
setlocal

somecommand 2> error.log

rem 「fatal」「critical」を含む行があればエラーとみなす
findstr /i "fatal critical" error.log > nul && (
    echo 致命的なエラーが検出されました
    exit /b 1
)

rem 「warning」のみなら警告として続行
findstr /i "warning" error.log > nul && (
    echo [WARNING] 警告が出力されましたが処理は続行します
)

echo 処理完了

注意：すべてのコマンドが stderr にエラーメッセージを出力するわけではありません。robocopy はエラー情報も stdout に出力するため、この方法では検知できません。対象コマンドの出力仕様を事前に確認してください。

@echo off
setlocal

rem コマンドを実行
somecommand

rem 出力ファイルの存在で成否を判定
if not exist "output.txt" (
    echo 出力ファイルが生成されませんでした
    exit /b 1
)

echo 処理成功: output.txt が生成されました

@echo off
setlocal

somecommand > output.csv

rem ファイルの存在チェック
if not exist "output.csv" (
    echo ファイルが存在しません
    exit /b 1
)

rem ファイルサイズの検証
for %%A in ("output.csv") do (
    if %%~zA equ 0 (
        echo ファイルは存在しますが空です
        exit /b 2
    )
    echo ファイルサイズ: %%~zA バイト
)

rem 方法1: パス末尾に \ を付ける
if exist "C:\output\" (
    echo ディレクトリが存在します
)

rem 方法2: NUL を使う（より確実）
if exist "C:\output\NUL" (
    echo ディレクトリが存在します
)

@echo off
setlocal

set BACKUP_DIR=D:\backup\%date:~0,4%%date:~5,2%%date:~8,2%
set SOURCE=C:\data\important.db

rem バックアップディレクトリの作成
if not exist "%BACKUP_DIR%" mkdir "%BACKUP_DIR%"

rem ソースファイルの存在確認
if not exist "%SOURCE%" (
    echo [ERROR] バックアップ元が見つかりません: %SOURCE%
    exit /b 1
)

rem コピー実行
copy /Y "%SOURCE%" "%BACKUP_DIR%\"

rem コピー結果の検証（ファイルサイズ比較）
for %%S in ("%SOURCE%") do set SRC_SIZE=%%~zS
for %%D in ("%BACKUP_DIR%\important.db") do set DST_SIZE=%%~zD

if not "%SRC_SIZE%"=="%DST_SIZE%" (
    echo [ERROR] ファイルサイズが一致しません（元: %SRC_SIZE% / 先: %DST_SIZE%）
    exit /b 2
)

echo [OK] バックアップ完了（%DST_SIZE% bytes）

ポイント：ファイルの存在だけでなく、ファイルサイズの一致も確認することで、コピーが途中で失敗するケース（ディスク容量不足など）も検知できます。

@echo off
setlocal enabledelayedexpansion

rem 期待するファイルの数
set EXPECTED_COUNT=5
set ACTUAL_COUNT=0

rem 出力ファイルを数える
for %%F in (output\*.csv) do set /a ACTUAL_COUNT+=1

if !ACTUAL_COUNT! lss %EXPECTED_COUNT% (
    echo [ERROR] ファイル数が不足しています（期待: %EXPECTED_COUNT% / 実際: !ACTUAL_COUNT!）
    exit /b 1
)

echo [OK] %ACTUAL_COUNT% ファイル確認済み

@echo off
setlocal

rem コマンド出力をログに保存
somecommand > result.log 2>&1

rem 成功メッセージの検索
find "SUCCESS" result.log > nul
if %ERRORLEVEL% neq 0 (
    echo 成功メッセージが見つかりません
    exit /b 1
)

rem エラーメッセージの検索
find "ERROR" result.log > nul
if %ERRORLEVEL% equ 0 (
    echo エラーメッセージが検出されました
    exit /b 2
)

echo 正常終了

FIND と FINDSTR の違い

• FIND: 固定文字列の完全一致検索。シンプルで高速
• FINDSTR: 正規表現対応。複雑なパターンマッチが可能
• 単純なキーワード検索には FIND、パターンマッチが必要なら FINDSTR を使う

@echo off
setlocal

somecommand > result.log 2>&1

rem 複数のエラーパターンを OR 検索
findstr /i /r "error fail abort exception" result.log > nul
if %ERRORLEVEL% equ 0 (
    echo [ERROR] エラーパターンが検出されました:
    findstr /i /r "error fail abort exception" result.log
    exit /b 1
)

rem 行頭が「[ERROR]」で始まる行を検索
findstr /r "^\[ERROR\]" result.log > nul
if %ERRORLEVEL% equ 0 (
    echo エラー行が見つかりました
    exit /b 2
)

@echo off
setlocal enabledelayedexpansion

rem ビルド実行
call msbuild project.sln /p:Configuration=Release > build.log 2>&1

rem エラー数をカウント
set ERROR_COUNT=0
for /f %%A in ('findstr /i /c:"error " build.log ^| find /c /v ""') do set ERROR_COUNT=%%A

rem 警告数をカウント
set WARN_COUNT=0
for /f %%A in ('findstr /i /c:"warning " build.log ^| find /c /v ""') do set WARN_COUNT=%%A

echo ビルド結果: エラー %ERROR_COUNT% 件 / 警告 %WARN_COUNT% 件

if !ERROR_COUNT! gtr 0 (
    echo [FAILED] ビルドエラーが検出されました
    findstr /i /c:"error " build.log
    exit /b 1
)

if !WARN_COUNT! gtr 10 (
    echo [WARNING] 警告が多数あります（%WARN_COUNT%件）
)

echo [OK] ビルド成功

実行結果（エラー0件・警告3件の場合）

ビルド結果: エラー 0 件 / 警告 3 件
[OK] ビルド成功

@echo off
setlocal enabledelayedexpansion

rem ディスクの空き容量を取得して検証
set FREE_SPACE=0
for /f "tokens=3" %%A in ('dir C:\ ^| findstr /c:"bytes free"') do set FREE_SPACE=%%A

echo 空き容量: %FREE_SPACE%

rem プロセスの実行状態を確認
set PROCESS_FOUND=0
for /f %%A in ('tasklist /fi "imagename eq notepad.exe" /nh ^| findstr /i "notepad"') do set PROCESS_FOUND=1

if !PROCESS_FOUND! equ 0 (
    echo [ERROR] notepad.exe が実行されていません
    exit /b 1
)

@echo off
setlocal enabledelayedexpansion

rem ping の応答時間を取得
set RESPONSE_TIME=0
for /f "tokens=5 delims==< " %%A in ('ping -n 1 google.com ^| findstr /i "time"') do (
    set RESPONSE_TIME=%%A
)

rem 応答時間が 1000ms 以上なら警告
if !RESPONSE_TIME! gtr 1000 (
    echo [WARNING] 応答時間が遅いです: !RESPONSE_TIME!ms
)

@echo off
setlocal

rem 処理前にフラグ変数をクリア
set "RESULT="

rem 処理実行（成功時にRESULTを設定）
call some_process.bat

rem 変数の存在で成否を判定
if not defined RESULT (
    echo [ERROR] 処理結果が設定されていません
    exit /b 1
)

echo 処理結果: %RESULT%

@echo off
setlocal enabledelayedexpansion

rem 処理前の値を保存
set "BEFORE=%MY_CONFIG%"

rem 設定更新処理を実行
call update_config.bat

rem 値が変化したか確認
if "!MY_CONFIG!"=="!BEFORE!" (
    echo [WARNING] 設定値が変更されていません
)

@echo off
setlocal

rem アプリケーションのインストール実行
start /wait installer.exe /silent

rem レジストリでインストール確認
reg query "HKLM\SOFTWARE\MyApp" /v "Version" > nul 2>&1
if %ERRORLEVEL% neq 0 (
    echo [ERROR] インストールが完了していません
    exit /b 1
)

rem バージョン値を取得して検証
for /f "tokens=3" %%A in ('reg query "HKLM\SOFTWARE\MyApp" /v "Version"') do set INSTALLED_VER=%%A

echo インストール済みバージョン: %INSTALLED_VER%

rem 期待するバージョンとの比較
if not "%INSTALLED_VER%"=="2.0.0" (
    echo [ERROR] 期待するバージョン（2.0.0）と異なります
    exit /b 2
)

echo [OK] インストール完了

注意：HKLM（HKEY_LOCAL_MACHINE）のレジストリを読み書きするには管理者権限が必要です。HKCU（HKEY_CURRENT_USER）は通常権限で操作できます。

@echo off
setlocal enabledelayedexpansion

rem MySQL サービスの状態を取得
set SVC_STATE=Unknown
for /f "tokens=2 delims==" %%A in ('wmic service where "name='MySQL'" get state /value') do (
    set "SVC_STATE=%%A"
)

rem 改行やスペースを除去
set "SVC_STATE=!SVC_STATE: =!"

if not "!SVC_STATE!"=="Running" (
    echo [ERROR] MySQL サービスが起動していません（状態: !SVC_STATE!）
    exit /b 1
)

echo [OK] MySQL サービスは正常に稼働中

@echo off
setlocal enabledelayedexpansion

rem 対象プロセスが実行中か確認
set PROC_COUNT=0
for /f %%A in ('wmic process where "name='java.exe'" get processid /value ^| find /c "="') do set PROC_COUNT=%%A

if !PROC_COUNT! equ 0 (
    echo [ERROR] Java プロセスが見つかりません
    exit /b 1
)

echo [OK] Java プロセス: !PROC_COUNT! 個実行中

注意：WMIC は Windows 10 21H1 以降で「非推奨」とされています。新規スクリプトでは PowerShell の Get-WmiObject や Get-CimInstance の使用を検討してください。

@echo off
setlocal enabledelayedexpansion

rem PowerShell でサービスの状態を取得
for /f %%A in ('powershell -NoProfile -Command "(Get-Service 'MySQL').Status"') do set STATUS=%%A

if not "!STATUS!"=="Running" (
    echo [ERROR] MySQL が停止しています: !STATUS!
    exit /b 1
)

@echo off
setlocal enabledelayedexpansion

set TARGET_URL=https://example.com/api/health

rem HTTP ステータスコードを取得
for /f %%A in ('powershell -NoProfile -Command "try { (Invoke-WebRequest -Uri '%TARGET_URL%' -UseBasicParsing -TimeoutSec 10).StatusCode } catch { $_.Exception.Response.StatusCode.value__ }"') do set HTTP_CODE=%%A

echo HTTP Status: !HTTP_CODE!

if not "!HTTP_CODE!"=="200" (
    echo [ERROR] ヘルスチェック失敗（HTTP !HTTP_CODE!）
    exit /b 1
)

echo [OK] サービスは正常に応答しています

@echo off
setlocal enabledelayedexpansion

rem 直近1時間のエラーイベント数を取得
for /f %%A in ('powershell -NoProfile -Command "(Get-EventLog -LogName Application -EntryType Error -After (Get-Date).AddHours(-1) -ErrorAction SilentlyContinue).Count"') do set ERR_COUNT=%%A

if not defined ERR_COUNT set ERR_COUNT=0

if !ERR_COUNT! gtr 0 (
    echo [WARNING] 直近1時間に !ERR_COUNT! 件のエラーイベントがあります
)

@echo off
setlocal enabledelayedexpansion

rem 開始時刻を記録（秒単位）
set START_TIME=%time%
for /f "tokens=1-3 delims=:." %%a in ("%START_TIME%") do (
    set /a START_SEC=%%a*3600+%%b*60+%%c
)

rem 処理実行
call heavy_process.bat

rem 終了時刻を記録
set END_TIME=%time%
for /f "tokens=1-3 delims=:." %%a in ("%END_TIME%") do (
    set /a END_SEC=%%a*3600+%%b*60+%%c
)

rem 経過時間（秒）
set /a ELAPSED=END_SEC-START_SEC
echo 処理時間: !ELAPSED! 秒

rem 異常に速い（5秒未満）場合は失敗の可能性
if !ELAPSED! lss 5 (
    echo [WARNING] 処理が異常に速く終了しました（期待: 30秒以上）
)

rem タイムアウト（300秒超）の場合
if !ELAPSED! gtr 300 (
    echo [ERROR] 処理がタイムアウトしました
    exit /b 1
)

ポイント：処理時間が「短すぎる」場合も注意が必要です。本来30秒かかるバッチが1秒で終わった場合、入力データが読めなかったなど内部的にスキップしている可能性があります。

@echo off
setlocal enabledelayedexpansion

rem ==============================
rem  データ処理バッチ（多層チェック版）
rem ==============================

set LOG_FILE=process_%date:~0,4%%date:~5,2%%date:~8,2%.log
set ERROR_FLAG=0

echo [%date% %time%] === 処理開始 === > %LOG_FILE%

rem --- Layer 1: 前提条件の確認 ---
if not exist "input\data.csv" (
    echo [ERROR] 入力ファイルが見つかりません >> %LOG_FILE%
    exit /b 1
)

rem --- Layer 2: || 演算子による即座のエラー検知 ---
copy /Y "input\data.csv" "work\data.csv" || (
    echo [ERROR] ファイルコピー失敗 >> %LOG_FILE%
    exit /b 2
)

rem --- Layer 3: stderr キャプチャ ---
call transform.bat "work\data.csv" > result.log 2> error.log

for %%A in (error.log) do if %%~zA neq 0 (
    echo [ERROR] stderr 出力あり >> %LOG_FILE%
    type error.log >> %LOG_FILE%
    set ERROR_FLAG=1
)

rem --- Layer 4: 出力ファイルの検証 ---
if not exist "output\result.csv" (
    echo [ERROR] 出力ファイルが生成されていません >> %LOG_FILE%
    set ERROR_FLAG=1
)

rem --- Layer 5: ログ内容の解析 ---
findstr /i "error fatal exception" result.log > nul && (
    echo [ERROR] 処理ログにエラーが含まれています >> %LOG_FILE%
    set ERROR_FLAG=1
)

rem --- 最終判定 ---
if !ERROR_FLAG! equ 1 (
    echo [%date% %time%] === 処理失敗 === >> %LOG_FILE%
    exit /b 1
)

echo [%date% %time%] === 処理完了 === >> %LOG_FILE%

多層エラーチェックの設計指針

• Layer 1（前提条件）: 入力ファイルや必要なディレクトリの存在確認
• Layer 2（即時検知）: || 演算子による致命的エラーの即座の検知
• Layer 3（stderr）: 標準エラー出力のキャプチャと内容確認
• Layer 4（成果物）: 期待する出力ファイルの存在とサイズの検証
• Layer 5（ログ解析）: 処理ログ内のエラーキーワード検索

@echo off
setlocal

robocopy "C:\source" "D:\dest" /MIR /LOG:robocopy.log
set RC=%ERRORLEVEL%

rem robocopy は 0-3 が正常、4-7 が警告、8以上がエラー
if %RC% geq 8 (
    echo [ERROR] robocopy でエラーが発生しました（code: %RC%）
    rem ログからエラー詳細を抽出
    findstr /i "ERROR" robocopy.log
    exit /b 1
)

if %RC% geq 4 (
    echo [WARNING] robocopy で警告があります（code: %RC%）
)

echo [OK] robocopy 完了（code: %RC%）

@echo off
set COUNT=0
for %%F in (*.txt) do (
    set /a COUNT+=1
    rem ここで %COUNT% は常に 0 が表示される（展開済み）
    echo %COUNT%
)

@echo off
setlocal enabledelayedexpansion
set COUNT=0
for %%F in (*.txt) do (
    set /a COUNT+=1
    rem !COUNT! で遅延展開される
    echo !COUNT!
)

rem NG: type が失敗しても findstr の結果で ERRORLEVEL が上書きされる
type missing_file.txt | findstr "pattern"

rem OK: 一旦ファイルに出力してから検索する
type data.txt > temp.txt 2> nul || (
    echo ファイルの読み込みに失敗しました
    exit /b 1
)
findstr "pattern" temp.txt

rem NG: & がコマンド区切りと解釈される
if "%VAR%"=="A&B" echo 一致

rem OK: ^ でエスケープする
if "%VAR%"=="A^&B" echo 一致

rem OK: 遅延展開を使う（特殊文字が安全に展開される）
if "!VAR!"=="A&B" echo 一致

rem NG: 「IF ERRORLEVEL 1」は「1以上」の意味
if ERRORLEVEL 1 echo エラー

rem OK: 明示的に比較する
if %ERRORLEVEL% neq 0 echo エラー（0以外）
if %ERRORLEVEL% equ 1 echo エラーコード1
if %ERRORLEVEL% gtr 0 echo 正の値のエラー

注意：IF ERRORLEVEL N は「ERRORLEVEL が N 以上」を意味します。特定の値と等しいかを判定するには IF %ERRORLEVEL% EQU N を使用してください。

ポイント：エラーチェック用のサブルーチンを CALL :label で呼び出すことで、メインロジックの可読性を保てます。それでも複雑になる場合は、PowerShell スクリプトへの移行を検討しましょう。

rem 存在しないファイルへのアクセスでエラーを発生させる
copy nonexistent_file.txt dest.txt

rem 指定したエラーコードで終了するテスト用バッチ
rem (test_error.bat)
@exit /b 1

rem stderr に出力するテスト
echo テストエラー 1>&2