Symfony Doctrine：ManyToOne关联中ID长度异常致迁移失败

我之前也碰到过这个坑！当你用自定义ID类型（比如stage_id、educational_area_id）时，执行doctrine:migrations:diff生成迁移文件，Doctrine经常会忽略实体ORM配置里指定的length:36，反而用默认的255长度，导致后续doctrine:migrations:migrate执行失败。

先看看你的实体ORM配置（我补全了EducationalArea的ID配置）：

App\Resources\Domain\Stage:
  type: entity
  fields:
    id:
      type: stage_id
      id: true
      length: 36
    name:
      type: string
  manyToOne:
    educationalAreaId:
      targetEntity: EducationalArea
      joinColumn:
        name: educationalAreaId
        referencedColumnName: id

App\Resources\Domain\EducationalArea:
  type: entity
  fields:
    id:
      type: educational_area_id
      id: true
      length: 36
    # 其他字段...

问题根源在于：Doctrine的自定义类型需要手动处理长度参数，默认不会自动识别实体配置里的length值。下面是解决步骤：

1. 让自定义ID类型类正确处理长度 #

你的自定义类型类（比如StageIdType）需要继承StringType，并在getSQLDeclaration方法里使用传入的长度参数。示例代码：

<?php

namespace App\Doctrine\Type;

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

class StageIdType extends StringType
{
    public const NAME = 'stage_id';

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

    public function getSQLDeclaration(array $column, AbstractPlatform $platform): string
    {
        // 优先用实体配置的length，默认36兜底
        $length = $column['length'] ?? 36;
        return $platform->getStringTypeDeclarationSQL([
            'length' => $length,
        ]);
    }

    // 如果你的ID是值对象，可以在这里实现convertToPHPValue和convertToDatabaseValue方法
}

同样的，EducationalAreaIdType也要做完全一样的处理，记得把NAME常量改成educational_area_id。

2. 在Symfony中注册自定义类型 #

打开config/packages/doctrine.yaml，在dbal的types节点下注册你的自定义类型：

doctrine:
    dbal:
        types:
            stage_id: App\Doctrine\Type\StageIdType
            educational_area_id: App\Doctrine\Type\EducationalAreaIdType
        # 其他数据库连接配置...

3. 重新生成迁移文件 #

先把之前生成的错误迁移文件删掉，然后重新执行diff命令：

php bin/console doctrine:migrations:diff

这时候打开新生成的迁移文件，你会看到ID字段的长度已经是36，而不是默认的255了。

4. 执行迁移 #

最后正常执行迁移命令即可：

php bin/console doctrine:migrations:migrate

额外排查点 #

如果还是没生效，可以试试这几点：

• 确认自定义类型的getName()返回的字符串，和ORM配置里的type值完全一致（大小写也要匹配）
• 清除Symfony缓存：php bin/console cache:clear，确保新配置生效
• 检查你的数据库平台是否支持指定长度（比如MySQL的varchar是完全支持的）

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