【bat】ERRORLEVELが常に1になる12の原因と修正方法 ── チェックリスト形式で完全解説

この記事で学べること

• ERRORLEVEL が常に 1 になる12の原因と、それぞれの修正方法
• set ERRORLEVEL= による環境変数の上書きトラップ
• 括弧ブロック内での %ERRORLEVEL% 展開タイミング問題と遅延展開
• find / findstr / robocopy などコマンド固有の終了コード仕様
• パイプ・リダイレクト・call / start が ERRORLEVEL に与える影響
• 原因を体系的に切り分ける診断スクリプトの書き方
• 実務で使える防御的コーディングパターン

@echo off

rem ログファイルにERRORがあるか検索
find "ERROR" app.log > nul

rem ここでERRORLEVELを確認
echo 結果: %ERRORLEVEL%

rem 「ERROR」がファイルに含まれていなければ ERRORLEVEL = 1
rem これは「エラー」ではなく「見つからなかった」という正常な結果

実行結果（app.logにERRORが含まれていない場合）

結果: 1

@echo off

find "ERROR" app.log > nul 2>&1

if %ERRORLEVEL% equ 0 (
    echo ERROR が見つかりました。ログを確認してください。
) else if %ERRORLEVEL% equ 1 (
    echo ERROR は見つかりませんでした。正常です。
) else (
    echo ファイルが見つからないか、構文エラーです。
)

ポイント：検索・比較系コマンドの ERRORLEVEL 1 は「エラー」ではなく「条件不一致」です。これらのコマンドの後で ERRORLEVEL を見るときは、コマンドの仕様書を確認し、各終了コードの意味を把握してから判定ロジックを書きましょう。

@echo off

rem find が一致なしで ERRORLEVEL = 1 を返す
find "NOTEXIST" data.txt > nul 2>&1

rem echo は ERRORLEVEL を更新しない → 1 のまま残る
echo 処理を続行します...

rem set も ERRORLEVEL を更新しない → まだ 1 のまま
set RESULT=OK

rem ここで確認すると、find の ERRORLEVEL = 1 がまだ残っている
echo ERRORLEVEL = %ERRORLEVEL%

実行結果

処理を続行します...
ERRORLEVEL = 1

@echo off

find "NOTEXIST" data.txt > nul 2>&1
echo find の結果: %ERRORLEVEL%

rem ERRORLEVEL を 0 にリセット
cmd /c exit /b 0

rem これで ERRORLEVEL = 0 からのリスタートになる
echo リセット後: %ERRORLEVEL%

実行結果

find の結果: 1
リセット後: 0

注意：cmd /c exit /b 0 は ERRORLEVEL をリセットする定番テクニックです。ver > nul でも 0 にリセットできますが、cmd /c exit /b N なら任意の値を設定できるため汎用性が高くおすすめです。

判断基準

• 外部コマンド（.exe / .com）→ 基本的に ERRORLEVEL を更新する
• 内部コマンドで処理を実行するもの（copy, move, del, mkdir 等）→ 更新する
• 内部コマンドで表示・設定のみのもの（echo, set, rem, title 等）→ 更新しない
• 不確かな場合は echo %ERRORLEVEL% で実際に確認する

@echo off

rem 存在しないファイルをコピー → ERRORLEVEL = 1
copy nonexist.txt dest.txt > nul 2>&1

rem ログ出力のつもりで dir を実行
dir C:\ > nul

rem ここで判定 → copy ではなく dir の ERRORLEVEL を見ている！
if %ERRORLEVEL% neq 0 (
    echo コピーに失敗しました
) else (
    echo コピーに成功しました
)

実行結果

コピーに成功しました

@echo off

copy nonexist.txt dest.txt > nul 2>&1
if %ERRORLEVEL% neq 0 (
    echo コピーに失敗しました（ERRORLEVEL=%ERRORLEVEL%）
    goto :ERROR
)

rem コピー成功後の処理
dir C:\ > nul
echo コピーに成功しました

@echo off

rem コマンド失敗時に即座にエラー処理へ
copy nonexist.txt dest.txt > nul 2>&1 || (
    echo コピーに失敗しました
    goto :ERROR
)

rem 成功した場合のみここに到達
echo コピーに成功しました

ポイント：|| を使えば ERRORLEVEL の上書きリスクを回避できます。ERRORLEVEL の明示的なチェックが不要な場面では、|| の方が安全で読みやすいコードになります。

@echo off

rem type は成功するが、find が一致なしで 1 を返す
type sample.txt | find "ABC" > nul

rem ERRORLEVEL は find の結果 = 1
echo ERRORLEVEL = %ERRORLEVEL%

実行結果（sample.txtにABCが含まれていない場合）

ERRORLEVEL = 1

@echo off

rem ステップ1: ファイル読み込み
type sample.txt > temp_output.txt 2>&1
if %ERRORLEVEL% neq 0 (
    echo ファイルの読み込みに失敗しました
    goto :CLEANUP
)

rem ステップ2: 文字列検索
find "ABC" temp_output.txt > nul
if %ERRORLEVEL% equ 0 (
    echo ABCが見つかりました
) else (
    echo ABCは見つかりませんでした（これはエラーではない）
)

:CLEANUP
if exist temp_output.txt del temp_output.txt

注意：パイプの前段コマンドが失敗した場合でも、ERRORLEVEL は後段コマンドの結果で上書きされます。つまり、前段のエラーがパイプによって「隠蔽」されることもあります。重要なコマンドの成否を判定する場合は、パイプを使わずに一時ファイルを経由するのが安全です。

@echo off

find "EXIST" data.txt > nul

rem この判定は ERRORLEVEL が 0 以上なら TRUE
rem → ERRORLEVEL は常に 0 以上なので、常に TRUE になる！
if ERRORLEVEL 0 (
    echo 正常終了
) else (
    echo エラー発生
)

@echo off

rem 何らかのコマンドを実行
somecommand

rem ERRORLEVEL が 1「以上」ならエラーメッセージ
if ERRORLEVEL 1 (
    echo ERRORLEVEL が 1 です
)

rem 仮に ERRORLEVEL = 2 でも「1 です」と表示される
rem 仮に ERRORLEVEL = 100 でも「1 です」と表示される

@echo off

somecommand

rem 等号比較: ERRORLEVEL が正確に 0 かどうか
if %ERRORLEVEL% equ 0 (
    echo 正常終了
) else if %ERRORLEVEL% equ 1 (
    echo ERRORLEVEL = 1（条件不一致など）
) else (
    echo ERRORLEVEL = %ERRORLEVEL%（その他のエラー）
)

@echo off

rem この時点で ERRORLEVEL = 0

if 1==1 (
    rem ブロック全体がパースされる時点で
    rem %ERRORLEVEL% は 0 に展開される

    find "NOTEXIST" data.txt > nul
    rem 実行後の ERRORLEVEL は 1 だが...

    echo ERRORLEVEL = %ERRORLEVEL%
    rem パース時に 0 に置換済みなので 0 と表示される
)

実行結果

ERRORLEVEL = 0

@echo off
setlocal enabledelayedexpansion

if 1==1 (
    find "NOTEXIST" data.txt > nul

    rem !ERRORLEVEL! なら実行時の値を参照できる
    echo ERRORLEVEL = !ERRORLEVEL!
)

実行結果

ERRORLEVEL = 1

@echo off

if 1==1 (
    find "NOTEXIST" data.txt > nul

    rem call を使うと %%ERRORLEVEL%% が実行時に展開される
    call echo ERRORLEVEL = %%ERRORLEVEL%%
)

実行結果

ERRORLEVEL = 1

遅延展開のまとめ

• %ERRORLEVEL% は括弧ブロック内ではパース時の値に固定される
• !ERRORLEVEL! は実行時の最新値を取得する（setlocal enabledelayedexpansion が必要）
• 遅延展開が使えない場合は call echo %%ERRORLEVEL%% で代用可能
• 括弧ブロック外（通常の行）では %ERRORLEVEL% でも正しく動作する

注意：robocopy では ERRORLEVEL = 1 は「ファイルが正常にコピーされた」という成功を意味します。「0以外＝エラー」の先入観で判定すると、正常動作なのにエラーとして処理してしまいます。

@echo off

robocopy C:\source C:\dest /MIR

rem robocopy の ERRORLEVEL = 1（コピー成功）を
rem エラーとして誤判定してしまう
if %ERRORLEVEL% neq 0 (
    echo エラーが発生しました！
    exit /b 1
)

@echo off

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

rem robocopy では 8 以上がエラー
if %RC% geq 8 (
    echo robocopy でエラーが発生しました（終了コード: %RC%）
    exit /b 1
)

rem 0〜7 は正常（0=変更なし, 1=コピー成功, 2=余分ファイル検出...）
echo robocopy 正常終了（終了コード: %RC%）

rem 後続処理のために ERRORLEVEL を 0 にリセット
cmd /c exit /b 0

ポイント：robocopy 以外にも、dsquery（Active Directory 検索）や schtasks（タスクスケジューラ）など、独自の終了コード体系を持つコマンドがあります。初めて使うコマンドは、必ず公式ドキュメントで終了コードの意味を確認しましょう。

@echo off

rem 意図せず ERRORLEVEL というユーザー変数を作成
set ERRORLEVEL=1

rem 成功するコマンドを実行
dir C:\ > nul

rem dir は成功（システムの ERRORLEVEL = 0）だが
rem ユーザー変数の ERRORLEVEL = 1 が優先される
echo ERRORLEVEL = %ERRORLEVEL%

実行結果

ERRORLEVEL = 1

@echo off

rem ユーザー変数 ERRORLEVEL を削除
rem （値なしで set すると変数が削除される）
set ERRORLEVEL=

rem これでシステムの ERRORLEVEL が参照されるようになる
dir C:\ > nul
echo ERRORLEVEL = %ERRORLEVEL%

実行結果

ERRORLEVEL = 0

rem ERRORLEVEL で始まる変数を一覧表示
set ERRORLEVEL

rem 出力例（ユーザー変数が存在する場合）:
rem ERRORLEVEL=1

rem 出力例（ユーザー変数が存在しない場合）:
rem 環境変数 ERRORLEVEL が定義されていません

注意：同じ問題は %CD%、%DATE%、%TIME%、%RANDOM% などのシステム疑似変数でも発生します。これらの名前でユーザー変数を作成すると、システム値が隠蔽されます。絶対にこれらの名前で set を使わないことが鉄則です。

@echo off

call :CHECK_FILE
echo 戻り後の ERRORLEVEL = %ERRORLEVEL%
goto :EOF

:CHECK_FILE
rem ファイルの存在チェック
if exist important.txt (
    echo ファイルが存在します
) else (
    echo ファイルが見つかりません
)

rem ログ検索（見つからなければ ERRORLEVEL = 1）
find "COMPLETED" process.log > nul 2>&1

rem exit /b を書いていないので、find の ERRORLEVEL がそのまま戻る
goto :EOF

実行結果（process.logにCOMPLETEDが含まれていない場合）

ファイルが存在します
戻り後の ERRORLEVEL = 1

@echo off

call :CHECK_FILE
if %ERRORLEVEL% equ 0 (
    echo チェック正常完了
) else (
    echo チェックでエラーが見つかりました
)
goto :EOF

:CHECK_FILE
if not exist important.txt (
    echo ファイルが見つかりません
    exit /b 1
)

find "COMPLETED" process.log > nul 2>&1
if %ERRORLEVEL% neq 0 (
    echo 処理完了マーカーが見つかりません
    exit /b 2
)

rem すべてのチェックをパス
exit /b 0

サブルーチン設計のベストプラクティス

• すべてのサブルーチンは exit /b N で明示的に終了コードを返す
• 正常終了は exit /b 0、エラーは exit /b 1（または原因別の値）
• goto :EOF は ERRORLEVEL を変更しない。意図的に値を制御するなら exit /b を使う
• 複数のチェックを行うサブルーチンでは、各チェック失敗時に異なる終了コードを返すと呼び出し元でのデバッグが容易になる

@echo off

rem 存在しないスクリプトを call
call nonexist.bat
echo ERRORLEVEL = %ERRORLEVEL%

rem 出力: ERRORLEVEL = 1
rem call で見つからないファイルを指定すると ERRORLEVEL = 1

@echo off

set SCRIPT=C:\scripts\process.bat

if not exist "%SCRIPT%" (
    echo スクリプトが見つかりません: %SCRIPT%
    exit /b 1
)

call "%SCRIPT%"
if %ERRORLEVEL% neq 0 (
    echo スクリプトの実行でエラーが発生しました
    exit /b %ERRORLEVEL%
)

@echo off

rem 読み取り専用のファイルにリダイレクト
dir C:\ > C:\readonly_file.txt
echo ERRORLEVEL = %ERRORLEVEL%

rem 存在しないフォルダへリダイレクト
dir C:\ > C:\nonexist_folder\output.txt
echo ERRORLEVEL = %ERRORLEVEL%

@echo off

set OUTPUT_DIR=C:\logs
set OUTPUT_FILE=%OUTPUT_DIR%\output.txt

rem 出力先ディレクトリの存在確認
if not exist "%OUTPUT_DIR%" (
    mkdir "%OUTPUT_DIR%"
)

rem 書き込みテスト
echo test > "%OUTPUT_FILE%" 2> nul
if %ERRORLEVEL% neq 0 (
    echo 出力先に書き込めません: %OUTPUT_FILE%
    exit /b 1
)

rem 本処理
dir C:\ > "%OUTPUT_FILE%"

@echo off

rem ループの前に ERRORLEVEL = 1 にしておく
find "NOTEXIST" dummy.txt > nul 2>&1

for %%f in (file1.txt file2.txt file3.txt) do (
    copy %%f backup\ > nul 2>&1
    rem copy が成功しても %ERRORLEVEL% は 1 のまま
    echo %%f: ERRORLEVEL = %ERRORLEVEL%
)

実行結果（全ファイルのコピーが成功した場合）

file1.txt: ERRORLEVEL = 1
file2.txt: ERRORLEVEL = 1
file3.txt: 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

    rem !ERRORLEVEL! なら各コマンドの実際の結果を取得できる
    if !ERRORLEVEL! neq 0 (
        echo %%f のコピーに失敗しました
        set /a ERROR_COUNT+=1
    ) else (
        echo %%f のコピーに成功しました
    )
)

echo 完了（エラー件数: !ERROR_COUNT!）

実行結果

file1.txt のコピーに成功しました
file2.txt のコピーに成功しました
file3.txt のコピーに成功しました
完了（エラー件数: 0）

ポイント：FOR ループ内で ERRORLEVEL を確認する場合は、必ず setlocal enabledelayedexpansion と !ERRORLEVEL! を使いましょう。%ERRORLEVEL% ではループ内の値が更新されません。エラーカウントなどの変数も同様に ! で参照する必要があります。

@echo off
setlocal enabledelayedexpansion

echo ============================================
echo  ERRORLEVEL 診断スクリプト
echo ============================================
echo.

rem ── チェック1: ユーザー変数の存在確認 ──
echo [1] ユーザー変数 ERRORLEVEL の確認
set ERRORLEVEL > nul 2>&1
if !ERRORLEVEL! equ 0 (
    echo     警告: ユーザー変数 ERRORLEVEL が存在しています！
    echo     対処: set ERRORLEVEL= で削除してください
) else (
    echo     OK: ユーザー変数は存在しません
)
echo.

rem ── チェック2: 基本的な ERRORLEVEL リセット ──
echo [2] ERRORLEVEL リセットの確認
cmd /c exit /b 0
echo     cmd /c exit /b 0 の後: !ERRORLEVEL!
if !ERRORLEVEL! neq 0 (
    echo     異常: リセットできません。環境に問題があります
) else (
    echo     OK: 正常にリセットできます
)
echo.

rem ── チェック3: 遅延展開の動作確認 ──
echo [3] 遅延展開の動作確認
cmd /c exit /b 0
if 1==1 (
    find "DIAG_TEST_STRING" "%~f0" > nul
    echo     括弧内 %%ERRORLEVEL%%: %ERRORLEVEL%
    echo     括弧内 ^^!ERRORLEVEL^^!: !ERRORLEVEL!
)
echo.

rem ── チェック4: 各コマンドの ERRORLEVEL ──
echo [4] 主要コマンドの ERRORLEVEL 確認
dir C:\ > nul 2>&1
echo     dir C:\          : !ERRORLEVEL!
ver > nul
echo     ver              : !ERRORLEVEL!
find "ZZZZZZZ" "%~f0" > nul 2>&1
echo     find（不一致）   : !ERRORLEVEL!
echo.

echo ============================================
echo  診断完了
echo ============================================
pause

正常時の実行結果

============================================
 ERRORLEVEL 診断スクリプト
============================================
.
[1] ユーザー変数 ERRORLEVEL の確認
    OK: ユーザー変数は存在しません
.
[2] ERRORLEVEL リセットの確認
    cmd /c exit /b 0 の後: 0
    OK: 正常にリセットできます
.
[3] 遅延展開の動作確認
    括弧内 %ERRORLEVEL%: 0
    括弧内 !ERRORLEVEL!: 0
.
[4] 主要コマンドの ERRORLEVEL 確認
    dir C:\          : 0
    ver              : 0
    find（不一致）   : 1
.
============================================
 診断完了
============================================

rem コマンド実行 → 直後に判定 → 変数に保存
somecommand args
set CMD_RESULT=%ERRORLEVEL%

rem 以降は CMD_RESULT で判定（ERRORLEVEL は上書きされてもOK）
if %CMD_RESULT% neq 0 (
    echo エラー発生: %CMD_RESULT%
)

@echo off

copy source.txt dest.txt > nul 2>&1 || goto :ERR_COPY
move temp.dat archive\ > nul 2>&1 || goto :ERR_MOVE
del /q temp\*.tmp > nul 2>&1 || goto :ERR_DEL

echo すべての処理が正常完了
exit /b 0

:ERR_COPY
echo エラー: ファイルのコピーに失敗しました
exit /b 1

:ERR_MOVE
echo エラー: ファイルの移動に失敗しました
exit /b 2

:ERR_DEL
echo エラー: 一時ファイルの削除に失敗しました
exit /b 3

@echo off
setlocal enabledelayedexpansion

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

for %%f in (C:\data\*.csv) do (
    set /a TOTAL+=1

    copy "%%f" C:\backup\ > nul 2>&1

    if !ERRORLEVEL! equ 0 (
        set /a SUCCESS+=1
    ) else (
        set /a FAIL+=1
        echo 失敗: %%f
    )
)

echo 処理結果: 合計 !TOTAL! / 成功 !SUCCESS! / 失敗 !FAIL!

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

@echo off

robocopy "%SOURCE%" "%DEST%" /MIR /R:3 /W:5 /NP
set RC=%ERRORLEVEL%

rem robocopy の終了コードを通常の 0/1 に正規化
if %RC% geq 8 (
    echo [ERROR] robocopy failed with exit code %RC%
    exit /b 1
)

rem 0〜7 は成功扱い
echo [OK] robocopy completed with exit code %RC%
exit /b 0

@echo off
setlocal enabledelayedexpansion

rem ── 初期設定 ──
set LOG_FILE=%~dp0logs\%~n0_%date:~0,4%%date:~5,2%%date:~8,2%.log
set EXIT_CODE=0

rem ── ログディレクトリ作成 ──
if not exist "%~dp0logs" mkdir "%~dp0logs"

rem ── 処理開始 ──
call :LOG "処理開始"

rem ── メイン処理 ──
call :EXEC "copy source.txt dest.txt"
if !ERRORLEVEL! neq 0 set EXIT_CODE=1

call :LOG "処理完了（終了コード: !EXIT_CODE!）"
exit /b !EXIT_CODE!

rem ── サブルーチン: コマンド実行＋ログ ──
:EXEC
call :LOG "実行: %~1"
%~1 > nul 2>>&1
set RC=!ERRORLEVEL!
if !RC! neq 0 (
    call :LOG "[ERROR] 終了コード: !RC!"
) else (
    call :LOG "[OK]"
)
exit /b !RC!

rem ── サブルーチン: ログ出力 ──
:LOG
echo %date% %time% %~1
echo %date% %time% %~1 >> "%LOG_FILE%"
exit /b 0

@echo off

rem ステップ1: ユーザー変数を削除
set ERRORLEVEL=

rem ステップ2: ERRORLEVEL を 0 に強制リセット
cmd /c exit /b 0

rem ステップ3: 確認
echo リセット後: %ERRORLEVEL%

rem ここで 0 にならない場合
rem → cmd.exe 自体の問題、またはシステム環境変数の問題

注意：近年のテキストエディタ（VS Code等）はデフォルトで UTF-8 を使用します。バッチファイルを保存する際は、エンコーディングを Shift_JIS（または ANSI）、改行を CRLF に設定してください。

ERRORLEVEL トラブル防止の3原則

• 原則1：判定は直後に ── ERRORLEVEL の確認は、対象コマンドの直後で行う。間にコマンドを挟まない
• 原則2：括弧内は遅延展開 ── if (...) や for ... do (...) の中では必ず !ERRORLEVEL! を使う
• 原則3：仕様を確認 ── 初めて使うコマンドは、終了コードの意味をドキュメントで確認してから判定ロジックを書く