Laravel报错：无法声明MailController类，名称已被占用求助

报错信息 #

local.ERROR: Cannot declare class App\Http\Controllers\MailController, because the name is already in use {"exception":"[object] (Symfony\Component\ErrorHandler\Error\FatalError(code: 0): Cannot declare class App\Http\Controllers\MailController, because the name is already in use at /home/.../app/Http/Controllers/SendMailController.php:0) [stacktrace] #0 {main} "}

问题描述 #

已确认该类名未在其他类中使用，命名空间配置也无问题，寻求解决办法。

可能的解决方案 #

• 修正文件名与类名的匹配：Laravel严格遵循PSR-4自动加载规范，文件名必须与类名完全一致（大小写敏感）。从报错路径看，你的文件名为SendMailController.php，但代码里声明的类是MailController，这直接导致冲突。要么将文件名改为MailController.php，要么将类名改为SendMailController。这是最可能触发该报错的原因。
• 清理Laravel缓存：执行以下命令清除类映射缓存，避免旧缓存导致的冲突：

  php artisan optimize:clear
  

• 更新Composer自动加载：如果修改过文件结构或命名空间，执行以下命令更新自动加载规则：

  composer dump-autoload
  

• 检查目录中的重复文件：确认app/Http/Controllers目录下没有其他同名（包括大小写不同）的MailController文件，Linux系统对文件名大小写敏感，容易出现这类隐性冲突。

相关代码 #

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Mail;
use App\Mail\SampleMail;

class MailController extends Controller
{
    public function index()
    {
        $content = [
            'subject' => 'This is the mail subject',
            'body' => 'This is the email body of how to send email from laravel 10 with mailtrap.'
        ];

        Mail::to('myemail@gmail.com')->send(new SampleMail($content));

        return "Email has been sent.";
    }
}

内容的提问来源于stack exchange，提问作者timoleon