Symfony 6.4 + MariaDB 11.3 UUID外键无效问题求助

问题背景 #

在Symfony 6.4项目中，User类使用UUID作为主键并配置原生UUID生成器，关联的UserLogin实体用于记录登录日志。手动将数据库中user.id和userlogin.user_id改为MariaDB 10.7+支持的原生UUID类型后，持久化UserLogin记录时触发报错：外键无效，原因是Doctrine将UUID以二进制(16)格式存入，而非原生UUID要求的字符串格式。

调试确认，Symfony\Bridge\Doctrine\Types\AbstractUidType的convertToDatabaseValue方法始终返回toBinary，核心原因是Doctrine未识别MariaDB 11.3已支持原生UUID类型。

无需修改vendor的解决方案 #

方案1：自定义Doctrine UUID类型 #

继承Symfony的AbstractUidType，重写hasNativeGuidType方法，让其识别MariaDB 10.7+版本的原生UUID支持：

// src/Doctrine/Type/CustomUuidType.php
namespace App\Doctrine\Type;

use Symfony\Bridge\Doctrine\Types\AbstractUidType;
use Doctrine\DBAL\Platforms\MariaDBPlatform;
use Doctrine\DBAL\Platforms\MySQLPlatform;

class CustomUuidType extends AbstractUidType
{
    public const NAME = 'uuid';

    protected function hasNativeGuidType($platform): bool
    {
        if ($platform instanceof MariaDBPlatform) {
            return version_compare($platform->getVersion(), '10.7.0', '>=');
        }
        // 可选：兼容MySQL 8.0.19+的原生UUID支持
        if ($platform instanceof MySQLPlatform) {
            return version_compare($platform->getVersion(), '8.0.19', '>=');
        }
        return parent::hasNativeGuidType($platform);
    }
}

在config/packages/doctrine.yaml中注册自定义类型，替换默认的uuid类型：

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

方案2：通过Doctrine事件监听修改平台配置 #

创建事件订阅者，在数据库连接初始化后，强制开启MariaDB的原生GUID支持：

// src/EventSubscriber/DoctrinePlatformSubscriber.php
namespace App\EventSubscriber;

use Doctrine\DBAL\Events;
use Doctrine\DBAL\Platforms\MariaDBPlatform;
use Doctrine\Common\EventSubscriber;
use Doctrine\DBAL\Event\ConnectionEventArgs;

class DoctrinePlatformSubscriber implements EventSubscriber
{
    public function getSubscribedEvents(): array
    {
        return [Events::postConnect];
    }

    public function postConnect(ConnectionEventArgs $args): void
    {
        $platform = $args->getConnection()->getDatabasePlatform();
        if ($platform instanceof MariaDBPlatform && version_compare($platform->getVersion(), '10.7.0', '>=')) {
            $platform->supportsNativeGuid = true;
        }
    }
}

在config/services.yaml中注册该订阅者：

services:
    App\EventSubscriber\DoctrinePlatformSubscriber:
        tags:
            - { name: doctrine.event_subscriber }

方案3：临时字段规则指定（简易Workaround） #

在User实体的ID字段注解中，显式指定原生类型标识：

#[ORM\Column(type: "uuid", unique: true, options: ['native_type' => 'UUID'])]

注：此方法仅为临时兼容方案，稳定性不如前两种，建议优先使用方案1或2。

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