自定义CustomBinaryUuid替代Ramsey后，Doctrine关联加载异常排查

你的问题核心是自定义CustomBinaryUuid替代Ramsey UUID后，Doctrine关联集合加载异常，仅第一个调用的关联能正常获取，后续关联为空。以下是最可能的遗漏点和解决办法：

1. 未正确实现equals()方法 #

Doctrine在匹配关联实体ID时会依赖equals()方法。如果你的CustomBinaryUuid没有正确实现该方法，会导致后续关联查询无法匹配到正确的实体，表现为集合为空。

正确实现示例：

class CustomBinaryUuid
{
    // ... 其他代码

    public function equals(mixed $other): bool
    {
        if (!$other instanceof self) {
            return false;
        }

        // 对比内部存储的二进制值或UUID字符串，确保一致性
        return $this->binaryValue === $other->binaryValue;
    }
}

2. 缺失hashCode()方法实现 #

Doctrine的PersistentCollection会依赖实体ID的哈希值做缓存和匹配逻辑。如果CustomBinaryUuid没有实现hashCode()，会导致Doctrine无法正确识别相同ID的实体，进而无法加载后续关联数据。

正确实现示例：

class CustomBinaryUuid
{
    // ... 其他代码

    public function hashCode(): int
    {
        // 基于二进制值生成稳定的哈希值
        return crc32($this->binaryValue);
    }
}

3. 直接使用原生binary类型而非自定义Doctrine类型 #

你将ORM配置中的uuid_binary改为原生binary类型，但Doctrine的原生binary会直接返回字符串，无法自动转换为你的CustomBinaryUuid对象，导致类型不匹配。

解决步骤：

• 创建自定义Doctrine类型，处理数据库二进制与CustomBinaryUuid的双向转换：

use Doctrine\DBAL\Types\Type;
use Doctrine\DBAL\Platforms\AbstractPlatform;

class CustomBinaryUuidType extends Type
{
    public const NAME = 'custom_binary_uuid';

    public function getSQLDeclaration(array $column, AbstractPlatform $platform)
    {
        // 定义MySQL中的二进制字段（长度16对应UUID二进制）
        return $platform->getBinaryTypeDeclarationSQL(['length' => 16]);
    }

    public function convertToPHPValue($value, AbstractPlatform $platform)
    {
        if ($value === null) {
            return null;
        }
        // 从数据库二进制转换为CustomBinaryUuid实例
        return CustomBinaryUuid::fromBinary($value);
    }

    public function convertToDatabaseValue($value, AbstractPlatform $platform)
    {
        if ($value === null) {
            return null;
        }
        // 从CustomBinaryUuid实例转换为数据库二进制
        return $value->toBinary();
    }

    public function getName()
    {
        return self::NAME;
    }
}

• 在Symfony配置中注册自定义类型（config/packages/doctrine.yaml）：

doctrine:
    dbal:
        types:
            custom_binary_uuid: App\Doctrine\Type\CustomBinaryUuidType

• 将实体ORM配置中的binary改为自定义类型custom_binary_uuid。

4. 关联映射的joinColumn类型未同步修改 #

检查所有关联映射的joinColumn配置，确保关联字段的type也设置为自定义的custom_binary_uuid，而非原生binary。类型不匹配会导致Doctrine无法正确关联实体。

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