Symfony 6.2 + Doctrine迁移后数据库架构与映射不同步问题

1. 修复Doctrine MariaDB平台配置 #

你当前配置里的options: { platform: mariadb }写法错误，导致Doctrine没能正确识别MariaDB平台，转而用了MySQL平台。直接修改为指定完整平台类名：

doctrine:
    dbal:
        # 保留其他原有配置
        server_version: 'mariadb-10.5.19' # 确保生产/预发布环境用对应版本
        platform: Doctrine\DBAL\Platforms\MariaDBPlatform
        # 删除原来options里的platform配置

也可以只保证server_version配置准确，让Doctrine自动推断平台，但显式指定类名更稳妥。

2. 强制清理服务器端缓存 #

服务器上的Doctrine元数据缓存可能过期，导致验证时调用旧的映射信息。执行以下命令清理：

# 清理Symfony整体缓存
php bin/console cache:clear --env=prod
# 清理Doctrine专属缓存池
php bin/console cache:pool:clear doctrine.system_cache_pool
php bin/console cache:pool:clear doctrine.result_cache_pool

3. 重新初始化迁移元数据存储 #

虽然你执行过sync-metadata-storage，但可以尝试重置迁移表：

# 先备份迁移表（需要保留历史记录的话）
mysqldump -u [你的数据库用户名] -p [你的数据库名] doctrine_migration_versions > migration_backup.sql

# 删除旧迁移表
DROP TABLE doctrine_migration_versions;

# 重新初始化迁移表
php bin/console doctrine:migrations:install

# 标记所有历史迁移为已执行（如果有旧迁移需要保留）
php bin/console doctrine:migrations:version --add --all

4. 处理Schema验证的细微差异 #

从schema:update --dump-sql的输出看，差异集中在datetime字段精度、字段默认值、注释一致性上——这是本地（MariaDB 10.10）和服务器（MariaDB 10.5）平台特性差异导致的：

• 在实体类里明确指定datetime字段的精度，比如：

/**
 * @ORM\Column(type="datetime_immutable", nullable=true, precision=6)
 */
private ?\DateTimeImmutable $updatedAt = null;

• 统一实体类中字段的nullable配置，确保和数据库实际状态一致
• 生产环境备份后，执行php bin/console doctrine:schema:update --force --complete同步这些差异

5. 验证平台识别是否正确 #

执行以下命令确认Doctrine当前使用的平台：

php bin/console debug:config doctrine dbal

检查输出中的platform值是否为Doctrine\DBAL\Platforms\MariaDBPlatform，确保服务器端已正确识别MariaDB平台。

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