Laravel中Repository与Service模式使用困惑：关联查询接口设计疑问

我在Laravel中尝试使用Repository和Service设计模式，但对关联查询的方法设计存在困惑。以包含id、name等字段的User模型为例，我已经创建了如下接口、仓库类、服务类及控制器：

现有代码实现 #

仓库接口：App\Repositories\Interfaces\IUserRepo.php #

/**
* user repository interface
*/
interface IUserRepo
{
    public function getAllUsers();
}

仓库实现：App\Repositories\UserRepository.php #

/**
* user repository
*/
class UserRepository implements IUserRepo
{
    protected User $userModel;
    
    public function __construct(User $userModel)
    {
        $this->userModel = $userModel;
    }
    
    public function getAllUsers()
    {
        return $this->userModel->get();
    }
}

服务类：App\Services\UserService.php #

/**
* user service
*/
class UserService
{
    protected UserRepository $userRepository;
    
    public function __construct(UserRepository $userRepository)
    {
        $this->userRepository = $userRepository;
    }
    
    public function userList()
    {
        return $this->userRepository->getAllUsers();
    }
}

控制器：App\Http\Controllers\UserController.php #

/**
* user controller
*/
class UserController
{
    protected UserService $userService;
    
    public function __construct(UserService $userService)
    {
        $this->userService = $userService;
    }
    
    public function index(Request $request)
    {
        $users = $this->userService->userList();
        
        return response()->json(['users' => $users]);
    }
}

核心疑问 #

每次需要进行表关联查询时，是否都要像下面这样在IUserRepo接口中新增对应的方法？这样会导致接口方法急剧膨胀，显然不是最优解：

interface IUserRepo
{
    public function getAllUsers();
    
    public function getAllUsersWithType();
    
    public function getAllUsersWithStatus();
    
    public function getAllUsersWithTypeAndStatus();
}

解决方案 #

1. 让仓库方法支持动态关联加载 #

不要为每种关联组合新增方法，而是改造仓库接口，允许传入需要加载的关联数组，实现灵活的关联查询：

改造后的仓库接口

interface IUserRepo
{
    // 新增$relations参数，默认空数组表示不加载关联
    public function getAllUsers(array $relations = []);
}

改造后的仓库实现

class UserRepository implements IUserRepo
{
    protected User $userModel;
    
    public function __construct(User $userModel)
    {
        $this->userModel = $userModel;
    }
    
    public function getAllUsers(array $relations = [])
    {
        $query = $this->userModel->query();
        
        // 若传入关联数组，则批量预加载
        if (!empty($relations)) {
            $query->with($relations);
        }
        
        return $query->get();
    }
}

2. 在Service层封装业务特定的查询 #

Service层的职责是处理业务逻辑，你可以在Service中根据不同业务场景调用仓库的通用方法，封装成业务友好的方法：

class UserService
{
    protected UserRepository $userRepository;
    
    public function __construct(UserRepository $userRepository)
    {
        $this->userRepository = $userRepository;
    }
    
    // 基础用户列表（无关联）
    public function getBasicUserList()
    {
        return $this->userRepository->getAllUsers();
    }
    
    // 加载用户关联的Type数据
    public function getUsersWithType()
    {
        return $this->userRepository->getAllUsers(['type']);
    }
    
    // 同时加载Type和Status关联
    public function getUsersWithTypeAndStatus()
    {
        return $this->userRepository->getAllUsers(['type', 'status']);
    }
}

3. 复杂查询的封装策略 #

如果遇到需要结合关联+条件筛选的复杂查询（比如“加载已激活用户的Type关联”），可以在仓库中封装特定方法，但只针对高频、复杂的场景，避免无意义的方法膨胀：

// IUserRepo接口新增
public function getActiveUsersWithType();

// UserRepository实现
public function getActiveUsersWithType()
{
    return $this->userModel->where('is_active', true)->with('type')->get();
}

4. 明确Repository与Service的职责边界 #

• Repository：专注于数据访问层的封装，屏蔽Model的具体实现，提供通用或复杂的数据查询能力，不处理业务逻辑。
• Service：专注于业务逻辑的编排，组合Repository提供的方法，处理业务规则、参数校验、事务控制等，对外提供业务友好的接口。

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