Doctrine Migrations Diff提示“未检测到映射信息变更”排查

你这情况我碰到过好几次，大概率是Doctrine没正确识别映射变化，或者缓存在搞鬼。给你几个排查和解决的步骤：

1. 别依赖自动推断，明确指定字段类型 #

你只删掉了type="integer"但没显式写type="string"，虽然Doctrine理论上能通过@var推断类型，但这玩意儿并不靠谱——尤其是你写的@var string city格式不对，正确的应该是@var string $city（少了个$符号，这会让Doctrine识别不到类型注解）。

直接把注解改明确：

class Customer{
    /**
     * @ORM\Column(type="string", nullable=true)
     * @var string $city
     */
    private $city;
}

2. 清掉Doctrine的元数据缓存 #

Doctrine会把实体的元数据缓存起来，就算你改了注解，它可能还在读旧缓存。执行下面的命令清缓存：

# 开发环境清缓存
php bin/console cache:clear

# 或者专门清Doctrine的元数据缓存
php bin/console doctrine:cache:clear-metadata

3. 先验证映射是否正确 #

先跑个命令检查实体映射有没有生效，确认Doctrine已经读到新的字段类型：

php bin/console doctrine:schema:validate

如果这个命令返回Mapping is valid，再重新生成迁移diff：

php bin/console doctrine:migrations:diff

4. 检查迁移配置（可选） #

要是上面都没用，去看看你的doctrine_migrations.yaml配置，有没有不小心忽略了Customer类所在的命名空间，或者扫描路径配置错了，导致Doctrine没扫到你的变更。

按这几步来，应该就能生成修改字段类型的迁移文件了。

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