Laravel 9依赖注入报错：目标接口无法实例化的问题求助

核心问题 #

报错由两个细节问题导致：

1. 接口类名拼写大小写不一致：
   • 控制器和接口文件中使用的接口类名是 UserRegisterRepositoryInterFace（末尾为 InterFace，Face 大写）
   • 但在 AppServiceProvider 中绑定的是 UserRegisterRepositoryInterface（末尾为 Interface，face 小写）
2. 仓库实现类缺少命名空间：
   • UserRegisterRepository 类未声明 App\Repositories 命名空间，但 AppServiceProvider 中绑定的是该命名空间下的类，导致容器无法找到实现类。

Laravel 服务容器对类的完全限定名（命名空间+类名）严格匹配，以上两个问题共同导致容器无法解析接口的实现，抛出"目标不可实例化"错误。

解决步骤 #

1. 统一接口类名拼写 #

按照 Laravel 通用命名规范，将接口类名统一为 UserRegisterRepositoryInterface（末尾 Interface 全小写后缀），修改所有引用该接口的文件：

（1）修改接口文件

将接口文件 app/Repositories/Interfaces/UserRegisterRepositoryInterFace.php 重命名为 UserRegisterRepositoryInterface.php，并修改文件内容：

<?php
namespace App\Repositories\Interfaces;

interface UserRegisterRepositoryInterface {
    public function storeUser($data);
}

（2）修改控制器中的引用

更新 CustomRegisterController 中的接口引用：

<?php
namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Http\Requests\RegisterUser;
use App\Repositories\Interfaces\UserRegisterRepositoryInterface; // 修改此处类名
use App\Models\Category;

class CustomRegisterController extends Controller
{
    private $registerUserRepository;

    public function __construct(UserRegisterRepositoryInterface $registerUserRepository) // 修改此处类名
    {
        $this->registerUserRepository = $registerUserRepository;
    }

    public function registerUser(RegisterUser $request){
        $data = $request->all();
        $this->registerUserRepository->storeUser($data);
        dd($data);
    }
}

（3）修改仓库实现类中的引用与命名空间

更新 UserRegisterRepository 类，补上命名空间并修正接口引用：

<?php
namespace App\Repositories; // 新增命名空间

use App\Repositories\Interfaces\UserRegisterRepositoryInterface; // 修改此处接口类名
use App\Models\User;

class UserRegisterRepository implements UserRegisterRepositoryInterface { // 修改此处接口类名
    public function storeUser($data){
        return User::create($data);
    }
}

2. 确认服务提供者绑定正确 #

AppServiceProvider 中的绑定代码无需修改，已正确使用统一后的接口类名和仓库命名空间：

$this->app->bind(UserRegisterRepositoryInterface::class, UserRegisterRepository::class);

3. 清理 Laravel 缓存 #

执行命令清除类映射缓存，确保新的类名和命名空间生效：

php artisan optimize:clear

额外说明 #

• Laravel 依赖注入严格依赖类的完全限定名（命名空间+类名）的精确匹配，开发时需保持命名一致性；
• 所有自定义类都应放在对应命名空间下，遵循 Laravel 的目录结构规范。

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