Laravel路由绑定报错：Call to undefined method ReflectionUnionType::getName()

问题根源 #

Laravel 10早期版本的路由模型绑定机制未适配PHP 8.0+引入的联合类型（Union Types）。当控制器方法使用Product | Post这类联合类型参数时，底层反射逻辑会尝试调用ReflectionUnionType::getName()，但该方法并不存在（ReflectionUnionType需通过getTypes()获取子类型），因此触发报错。

可行解决方法 #

方法1：使用接口/父类替代联合类型

创建一个统一的接口或抽象类，让Product和Post实现/继承，以此作为控制器参数类型：

1. 定义Commentable接口：

   // app/Contracts/Commentable.php
   namespace App\Contracts;
   
   interface Commentable
   {
       // 定义评论关联方法
       public function comments();
   }
   

2. 在Product和Post模型中实现该接口：

   // app/Models/Product.php
   use App\Contracts\Commentable;
   
   class Product extends Model implements Commentable
   {
       // 原有代码...
       public function comments()
       {
           return $this->morphMany(Comment::class, 'commentable');
       }
   }
   

   // app/Models/Post.php
   use App\Contracts\Commentable;
   
   class Post extends Model implements Commentable
   {
       // 原有代码...
       public function comments()
       {
           return $this->morphMany(Comment::class, 'commentable');
       }
   }
   

3. 修改控制器方法参数类型，并调整路由模型绑定：

   // 控制器方法
   public function index(Commentable $commentable)
   {
       return $commentable->comments;
   }
   

   在RouteServiceProvider的boot方法中注册自定义模型绑定：

   public function boot()
   {
       parent::boot();
   
       Route::bind('commentable', function ($id, $route) {
           $type = $route->parameter('commentableType');
           return match($type) {
               'product' => \App\Models\Product::findOrFail($id),
               'post' => \App\Models\Post::findOrFail($id),
               default => abort(404, 'Invalid commentable type'),
           };
       });
   }
   

方法2：手动解析模型参数

放弃路由模型绑定的自动解析，直接在控制器中接收类型和ID参数，手动实例化模型：

public function index(string $commentableType, int $commentableId)
{
    $modelClass = match($commentableType) {
        'product' => \App\Models\Product::class,
        'post' => \App\Models\Post::class,
        default => abort(404, 'Invalid commentable type'),
    };

    $commentable = $modelClass::findOrFail($commentableId);
    // 后续评论查询逻辑
    return $commentable->comments;
}

方法3：升级Laravel版本

如果项目允许，可将Laravel 10升级到10.10.0及以上版本，该版本修复了路由模型绑定对联合类型的支持问题，无需修改现有代码即可解决报错。

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