この記事でやること

✅ エラー内容（Your local changes would be overwritten by merge）

✅ 改善要点（本番で直接編集しない／pull-only 運用）

✅ 改善手順解説（今すぐの復旧／退避してpull／全部捨てる／恒久対策：環境変数で切替）

環境

▪️ サーバ: Xserver（一般的な共有ホスティングでも可）

▪️ PHP: 8.2

▪️ フレームワーク: Laravel 9

▪️ 本番配置: リポ直下に src/（Laravel 本体）

▪️ スケジューラ実行: cron → php artisan schedule:run（毎分）

✅ エラー内容

本番で app/Console/Kernel.php を“テストのために everyMinute に直接変更”した後、 git pull したら止まる。

$ git pull origin main
From github.com:xxxx/your-repo
 * branch            main       -> FETCH_HEAD
Updating 1b88bf0..c133db0
error: Your local changes to the following files would be overwritten by merge:
    src/app/Console/Kernel.php
Please, commit your changes or stash them before you can merge.
Aborting

理由: 本番ワークツリーに“未コミットの変更”があると、git pull は安全のため止まる。

✅ 改善要点（結論）

⭕️ 本番でコードを直接編集しない
→ テスト用の差分は捨てる or 退避して pull-only に戻す。

⭕️ 以後のテスト切替は .env の環境変数で行う
→ コードをいじらずにスケジュール（everyMinute / 毎日 03:00 など）を切替できる。

✅ 改善手順解説

すぐ復旧：ローカル差分を捨てて pull

テスト用に触った Kernel.php のローカル差分は捨ててリモートを取り込む。

# そのファイルの差分だけ捨てる（Git 2.23+）
git restore src/app/Console/Kernel.php
# 古いGitなら
# git checkout -- src/app/Console/Kernel.php

git pull --rebase origin main

他にも複数ファイルを触ってしまって全部捨てたい場合はこれ（⚠️未コミット差分が全消去）：

# （※未コミット差分は全消去）
git fetch origin && git reset --hard origin/main

git pull --rebase origin main

今後楽な方法

恒久対策：環境変数でスケジュール切替（本番でコードを触らない）

Kernel を分岐させ、.env のフラグで “毎分テスト” と “本番スケジュール” を切替できるようにします。

app/Console/Kernel.php

protected function schedule(Schedule $schedule): void
{
    if(env('SCHEDULE_DEBUG', false)) {
        // 検証／ローカル向け（毎分）
        $schedule->command('tasks:delete-old-completed')->everyMinute();
        $schedule->command('send:daily-slack')->everyMinute();
    } else {
        // 本番向け（定刻）
        $schedule->command('tasks:delete-old-completed')->dailyAt('03:00');
        $schedule->command('send:daily-slack')->dailyAt('04:00');
    }
}

本番.env

SCHEDULE_DEBUG=false

ローカル／検証 .env

SCHEDULE_DEBUG=true

動作確認

# 次回実行予定
php artisan schedule:list

# その場で実行対象があれば走る
php artisan schedule:run -v