Symfony6.4升级Doctrine ORM2.2至3.0遇getColumnName()返回值类型错误

错误说明 #

Doctrine\ORM\Mapping\DefaultQuoteStrategy::getColumnName(): Return value must be of type string, null returned

该错误的核心原因是Doctrine ORM 3.0将字段映射（FieldMapping）从数组结构改为了对象API，你的项目仍在使用旧的数组形式元数据，导致新版本无法正确解析列名，最终返回null。

解决方案 #

1. 清理缓存并重新生成元数据 #

先清除旧的缓存元数据（数组形式），强制生成符合3.0要求的对象映射：

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

2. 适配自定义Doctrine扩展 #

你的配置中使用了自定义过滤器DeletedFilter和自定义DBAL类型，需要修改这些代码适配新的对象API：

• 自定义过滤器中，替换数组访问方式（如$fieldMapping['columnName']）为对象方法调用：$fieldMapping->getColumnName()
• 自定义DBAL类型如果涉及映射逻辑，确保兼容ORM 3.0的对象映射规范

3. 验证实体映射配置 #

检查所有实体类的注解配置：

• 确保每个字段都正确使用#[Column]注解，无必填参数遗漏（如type）
• 关联映射（如#[ManyToOne]、#[OneToMany]等）需符合ORM 3.0规范，避免使用已废弃的注解参数

4. 同步依赖版本 #

确保Symfony与Doctrine依赖版本完全兼容：

• 检查composer.json中doctrine/orm版本为^3.0，symfony/doctrine-bundle版本适配Symfony 6.4（建议^2.8及以上）
• 执行命令更新依赖：

composer update doctrine/orm symfony/doctrine-bundle --with-all-dependencies

如果以上步骤无效，排查项目中是否有第三方Bundle或自定义代码直接操作Doctrine元数据数组，这类代码需全部改为使用ORM 3.0的对象API。

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