Laravel『Class Not Found』エラーの原因と対処法

Class 'App\Services\UserService' not found
Class 'Foo\Bar\Hoge' not found
Target class [UserController] does not exist.
Class 'App\Http\Controllers\Auth\LoginController' not found
Class 'CreateUsersTable' not found

<?php

// ファイル: app/Services/UserService.php
namespace App\Service;   // ← Service（単数）になっている

class UserService
{
    //
}

use App\Services\UserService;  // ← Services（複数）を指定している

$userService = new UserService();  // Class 'App\Services\UserService' not found

// 正: namespace と use を揃える
namespace App\Services;

class UserService
{
    //
}

"autoload": {
    "psr-4": {
        "App\\": "app/"
    }
}

# NG な構成例
app/
  Services/
    User/
      UserService.php   # 中身のnamespaceが App\Services\UserService になっている

<?php

// ファイル: app/Services/User/UserService.php
namespace App\Services\User;

class UserService
{
    //
}

use App\Services\User\UserService;

# オートロード情報を更新
composer dump-autoload

# 開発環境では最適化付きもよく使う
composer dump-autoload -o

// Laravel 8以降で古い書き方をしているケース
Route::get('/users', 'UserController@index');  // これだけだとClass解決に失敗することがある

use App\Http\Controllers\UserController;

Route::get('/users', [UserController::class, 'index']);

<?php

namespace App\Http\Controllers\Admin;

class UserController extends Controller
{
    //
}

use App\Http\Controllers\Admin\UserController;

Route::get('/admin/users', [UserController::class, 'index']);

// config/app.php

'aliases' => [
    // ...
    'MyService' => App\Facades\MyService::class,
],

Class 'App\Facades\MyService' not found

// 例: 正しい名前空間に揃える
'aliases' => [
    'MyService' => App\Support\MyService::class,
],

php artisan config:clear
php artisan config:cache

php artisan migrate
# Class 'CreateUsersTable' not found

<?php

// ファイル: database/migrations/2024_01_01_000000_create_users_table.php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreateUsersTable extends Migration   // ← このクラス名とファイル名の一部が対応している必要
{
    public function up()
    {
        //
    }

    public function down()
    {
        //
    }
}

// DatabaseSeeder.php
public function run()
{
    $this->call([
        UsersTableSeeder::class,   // ← 実際のクラス名と一致させる
    ]);
}

php artisan make:job SendWelcomeMail

<?php

namespace App\Jobs;

class SendWelcomeMail implements ShouldQueue
{
    //
}

use App\Jobs\SendWelcomeMail;

SendWelcomeMail::dispatch($user);

# ファイル名
app/Services/userservice.php

# クラス定義
class UserService { ... }

# 呼び出し側
use App\Services\UserService;

1) エラーメッセージに出ているクラス名 (例: App\Services\UserService) を正確にメモする
2) そのクラスの「ファイルパス」と「namespace」が実際にどうなっているかを確認する
   - app/ 配下なら PSR-4 で App\ に対応しているか
3) 呼び出し側の use 宣言が正しいか（use App\Services\UserService; など）
4) Route / Controller の指定方法がLaravelのバージョンに合っているか
   - Route::get([...]) 記法や Target class エラーに注意
5) config/app.php の aliases / providers に間違ったクラス名を書いていないか
6) artisan コマンド実行時なら、Migration / Seeder / Job のクラス名・ファイル名が一致しているか
7) composer.json のautoload設定を変更したなら、composer dump-autoload を実行したか
8) WindowsとLinuxで動作が違うなら、ファイル名とクラス名の大文字小文字をすべて揃えたか