Laravel 9注册ServiceProvider后提示类未找到问题求助

1. 检查文件与类名的一致性 #

• 确保AdminServiceProvider.php文件名大小写和类名完全匹配（PSR-4规范对大小写敏感），比如不能写成adminserviceprovider.php，类名必须为AdminServiceProvider。
• 打开AdminServiceProvider.php文件，确认顶部命名空间是namespace Dkul\Admin;，无拼写错误。

2. 修正主项目composer.json自动加载配置 #

主项目的composer.json中，自动加载项需保证格式正确：

"autoload": {
    "psr-4": {
        "App\\": "app/",
        "Dkul\\Admin\\": "custompackage/Dkul/Admin/src/"
    }
}

注意路径末尾的斜杠/，以及JSON中命名空间的双反斜杠转义。

3. 重新生成自动加载映射 #

执行命令让Composer更新类映射：

composer dump-autoload

修改composer配置后必须执行此命令，否则Laravel无法识别新的命名空间映射。

4. 确认自定义包的composer.json配置（若包独立管理） #

如果自定义包有独立的composer.json，需保证其PSR-4配置正确：

"autoload": {
    "psr-4": {
        "Dkul\\Admin\\": "src/"
    }
}

本地开发时，可在主项目composer.json中配置本地仓库引入该包，而非直接写路径。

5. 清除Laravel缓存 #

缓存可能导致配置不生效，执行以下命令清除：

php artisan cache:clear
php artisan config:clear

6. 验证文件路径准确性 #

确认实际文件路径为custompackage/Dkul/Admin/src/AdminServiceProvider.php，无层级或文件夹名拼写错误（比如Dkul误写为DkuL）。

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