Laravel 11自定义键路由模型绑定失效问题求助

问题核心原因 #

你的favourites表是无主键的用户关联表，仅靠user_id无法定位唯一的模型实例（一个用户可收藏多个用户，user_id会重复），而Laravel路由模型绑定默认需要通过唯一键（主键或唯一索引）获取单条记录，这是导致绑定返回空的根本原因。

有效解决方案 #

方案1：添加复合主键（推荐） #

先给表设置复合主键（user_id + favourite_user_id），确保每条记录唯一：

// 迁移文件
Schema::create('favourites', function (Blueprint $table) {
    $table->unsignedBigInteger('user_id');
    $table->unsignedBigInteger('favourite_user_id');
    
    // 设置复合主键
    $table->primary(['user_id', 'favourite_user_id']);
    
    // 可选：添加外键约束
    $table->foreign('user_id')->references('id')->on('users')->onDelete('cascade');
    $table->foreign('favourite_user_id')->references('id')->on('users')->onDelete('cascade');
});

然后在Favourite模型中自定义路由绑定解析逻辑，支持复合参数：

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Favourite extends Model
{
    public $timestamps = false; // 表无时间戳字段时添加
    protected $primaryKey = ['user_id', 'favourite_user_id'];
    public $incrementing = false; // 关闭自增主键

    // 自定义路由绑定解析
    public function resolveRouteBinding($value, $field = null)
    {
        // 约定路由参数用逗号拼接两个ID，比如 /favourites/1,3
        [$userId, $favouriteUserId] = explode(',', $value);
        
        return $this->where('user_id', $userId)
                    ->where('favourite_user_id', $favouriteUserId)
                    ->firstOrFail();
    }
}

路由保持原有定义：

Route::apiResource('favourites', FavouriteController::class)->only(['index', 'store', 'destroy']);

请求时使用DELETE /api/favourites/{user_id},{favourite_user_id}格式，比如DELETE /api/favourites/1,3。

方案2：基于当前登录用户的自定义绑定 #

如果删除的是当前登录用户的收藏，可直接结合auth()->id()定位记录，无需修改表结构：
在RouteServiceProvider的boot方法中注册自定义绑定：

namespace App\Providers;

use App\Models\Favourite;
use Illuminate\Support\Facades\Route;
use Illuminate\Foundation\Support\Providers\RouteServiceProvider as ServiceProvider;

class RouteServiceProvider extends ServiceProvider
{
    public function boot()
    {
        parent::boot();

        // 自定义Favourite路由绑定逻辑
        Route::bind('favourite', function ($favouriteUserId) {
            return Favourite::where('user_id', auth()->id())
                            ->where('favourite_user_id', $favouriteUserId)
                            ->firstOrFail();
        });
    }
}

路由保持不变，请求时传递favourite_user_id作为参数：

DELETE /api/favourites/3

控制器方法无需修改，$favourite会自动绑定到当前用户对应收藏的记录。

方案3：显式路由参数拆分 #

直接在路由中传递两个参数，手动查询记录：

// 替换原有destroy路由
Route::apiResource('favourites', FavouriteController::class)->only(['index', 'store']);
Route::delete('favourites/{user_id}/{favourite_user_id}', [FavouriteController::class, 'destroy']);

修改控制器destroy方法：

public function destroy($userId, $favouriteUserId)
{
    $favourite = Favourite::where('user_id', $userId)
                          ->where('favourite_user_id', $favouriteUserId)
                          ->firstOrFail();
    $favourite->delete();
    
    return response()->noContent();
}

请求格式为DELETE /api/favourites/1/3。

为什么之前的方法无效 #

1. 仅设置getRouteKeyName为user_id：user_id字段不唯一，Laravel无法找到单条记录，返回空。
2. 路由参数指定favourite:user_id：同样面临user_id不唯一的问题，无法定位唯一实例。
3. 拆分路由的参数名错误：路由中用{favourites:user_id}，但控制器参数是Favourite $favourite，参数名不匹配，且依然存在user_id不唯一的问题。

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