Symfony 5.4中MakerBundle自动添加冗余注释的阻止方法求助

一、阻止MakerBundle自动生成DC2Type注释 #

问题根源是Doctrine在对比实体与数据库schema时，会自动为json类型字段添加(DC2Type:json)注释，按以下步骤彻底解决：

1. 修正实体字段类型
   确保实体中对应字段的注解从废弃的json_array改为json：

// 原废弃写法
// /** @ORM\Column(type="json_array") */

// 修正后写法
/** @ORM\Column(type="json") */
private $myRow;

2. 修改Doctrine配置禁用类型注释
   在config/packages/doctrine.yaml中，为json类型添加commented: false配置，让Doctrine生成迁移时不再附加类型注释：

doctrine:
    dbal:
        # 保留原有DBAL配置...
        types:
            json:
                class: Doctrine\DBAL\Types\JsonType
                commented: false

完成以上配置后，后续执行make:migration时，就不会自动生成带COMMENT '(DC2Type:json)'的SQL语句了。

二、旧迁移的更优处理方案 #

你之前手动修改旧迁移并单独写迁移移除注释的方式可行，可通过以下方式优化：

1. 批量清理现有字段注释
   如果多个表存在类似废弃注释，无需逐个表编写迁移，可在一次迁移中执行批量SQL操作（以MySQL为例）：

public function up(Schema $schema): void
{
    // 清理单个表字段注释
    $this->addSql('ALTER TABLE my_table CHANGE my_row my_row LONGTEXT NOT NULL');
    
    // 多表场景可依次添加类似语句，或根据数据库类型编写批量处理的原生SQL
}

2. 固化迁移基准
   当所有旧迁移的注释问题处理完成后，建议执行以下操作确保后续迁移基准正确：

• 执行doctrine:schema:update --dump-sql验证当前数据库schema与实体映射完全一致
• 若已完成所有现有迁移的执行，可删除旧迁移文件，执行make:migration生成全新的初始迁移，避免后续迁移依赖旧的废弃配置

注意：操作前务必备份数据库，防止数据丢失。

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