Symfony应用中Doctrine UUID v4转换异常问题求助

1. 检查关联实体EmailTo的外键配置 #

首先确认EmailTo实体中关联EmailFormType的外键字段，必须和主实体的ID字段类型保持一致，使用UuidType：

#[ORM\Entity(repositoryClass: EmailToRepository::class)]
#[ORM\Table(name: 'WORKSPACE_EMAIL_TO')]
class EmailTo {
    // 其他字段省略...
    #[ORM\ManyToOne(targetEntity: EmailFormType::class, inversedBy: 'emailsTo')]
    #[ORM\JoinColumn(name: 'email_form_type_id', referencedColumnName: 'id', type: UuidType::NAME)]
    private ?EmailFormType $emailFormType = null;

    // 对应的getter/setter方法
}

2. 强制Doctrine将UUID以字符串形式适配Oracle #

Oracle的VARCHAR2字段存储的是字符串格式UUID，但Doctrine默认的UuidType会把UUID序列化为二进制格式发送到数据库，导致查询匹配失败，可通过两种方式调整：

方法一：改用Doctrine的guid类型 #

guid类型在Oracle环境下会自动以字符串形式处理UUID，修改实体字段配置：

// EmailFormType的ID字段
#[ORM\Id]
#[ORM\Column(name:"id", type: 'guid', unique: true, nullable: false)]
#[ORM\GeneratedValue(strategy: 'CUSTOM')]
#[ORM\CustomIdGenerator(class: 'doctrine.uuid_generator')]
private Uuid $id;

// EmailTo的外键字段
#[ORM\JoinColumn(name: 'email_form_type_id', referencedColumnName: 'id', type: 'guid')]

方法二：自定义Oracle专属UUID类型 #

如果需要保留UuidType，可以创建自定义类型确保UUID转为字符串：

use Doctrine\DBAL\Types\Type;
use Doctrine\DBAL\Platforms\OraclePlatform;
use Symfony\Bridge\Doctrine\Types\UuidType as SymfonyUuidType;

class OracleUuidType extends SymfonyUuidType
{
    public function convertToDatabaseValue($value, OraclePlatform $platform)
    {
        if ($value === null) {
            return null;
        }
        return (string) $value;
    }
}

然后在config/packages/doctrine.yaml中注册该类型：

doctrine:
    dbal:
        types:
            uuid: App\Doctrine\Type\OracleUuidType

3. 验证数据库存储格式 #

确保WORKSPACE_EMAIL_FORM_TYPE.id和WORKSPACE_EMAIL_TO.email_form_type_id存储的是标准字符串格式UUID（带或不带连字符均可，但需保持一致），而非二进制数据。

4. 清理缓存 #

修改实体配置后，清理Doctrine元数据缓存和应用缓存：

php bin/console doctrine:cache:clear-metadata
php bin/console cache:clear

调整完成后，Doctrine生成的SQL查询会使用字符串格式的UUID进行匹配，即可正确获取关联的EmailTo实体。

内容的提问来源于stack exchange，提问作者Rémi LCD