Symfony中Uuid::uuid4()生成LazyUuidFromString引发类型错误

控制器代码 #

<?php

namespace App\Infrastructure\Controller;

use App\Application\Command\CreateUserCommand;
use Ramsey\Uuid\Uuid;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\Messenger\MessageBusInterface;

class UserController extends AbstractController
{

    public function __construct(private MessageBusInterface $bus){}

    public function createUser(Request $request):JsonResponse
    {

        $data = json_decode($request->getContent(),true);

    
        $userCommand = new CreateUserCommand(
            $id = Uuid::uuid4(),
            $data['email'],
            $data['name'],
            $data['surname'],
            $data['password']
        );
        
        $this->bus->dispatch($userCommand);
        
        return new JsonResponse($data);
    }
}

报错信息 #

App\Application\Command\CreateUserCommand::__construct(): Argument #1 ($id) must be of type Ramsey\Uuid\Uuid, Ramsey\Uuid\Lazy\LazyUuidFromString given, called in /var/www/html/src/User/Infrastructure/Controller/UserController.php on line 28

解决方案 #

原因分析 #

Ramsey Uuid 4.x及以上版本中，Uuid::uuid4()返回的是Ramsey\Uuid\UuidInterface接口的实现类实例（比如LazyUuidFromString），而非具体的Ramsey\Uuid\Uuid类。你的CreateUserCommand构造函数指定了具体类类型，触发了类型校验失败。

解决方法 #

1. 推荐：修改命令类参数类型为接口
   打开CreateUserCommand类，将构造函数的$id参数类型从Ramsey\Uuid\Uuid改为Ramsey\Uuid\UuidInterface，所有实现该接口的Uuid类都能正常传入：

   <?php
   
   namespace App\Application\Command;
   
   use Ramsey\Uuid\UuidInterface;
   
   class CreateUserCommand
   {
       public function __construct(
           private UuidInterface $id,
           private string $email,
           private string $name,
           private string $surname,
           private string $password
       ) {}
   
       // 其他业务方法...
   }
   

2. 不推荐：强制转换为具体Uuid类
   若必须使用具体的Uuid类，可通过先转字符串再解析的方式生成实例，但这属于冗余操作，会额外消耗性能：

   $userCommand = new CreateUserCommand(
       $id = Uuid::fromString(Uuid::uuid4()->toString()),
       $data['email'],
       $data['name'],
       $data['surname'],
       $data['password']
   );
   

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