升级MySQL 5.7.20后Doctrine无法识别NULL默认值列导致同步异常

你遇到的这个问题很典型——MariaDB 10.2.x版本在INFORMATION_SCHEMA.COLUMNS表中，会把可空列的COLUMN_DEFAULT值返回成字符串'NULL'，而不是MySQL旧版本（以及Doctrine 2.5.x预期的）原生NULL值。这就导致Doctrine每次做schema对比时，都认为这些列的默认值不匹配，重复生成ALTER TABLE ... DEFAULT NULL的语句。

下面给你几个可行的解决方案，按推荐程度排序：

1. 升级Doctrine DBAL版本（最推荐） #

Doctrine团队在DBAL 2.6及以上版本中已经修复了这个MariaDB的兼容问题。如果你项目的依赖允许，直接把doctrine/dbal的版本升级到~2.6.0或更高版本即可。修改composer.json后执行composer update doctrine/dbal，问题就能彻底解决。

2. 自定义MySQLSchemaManager处理字符串'NULL' #

如果暂时没法升级Doctrine，可以通过自定义SchemaManager来把字符串'NULL'转换成原生NULL，让Doctrine识别正确的默认值。

步骤1：创建自定义SchemaManager类 #

use Doctrine\DBAL\Schema\MySQLSchemaManager;
use Doctrine\DBAL\Connection;

class CustomMySQLSchemaManager extends MySQLSchemaManager
{
    public function __construct(Connection $conn)
    {
        parent::__construct($conn);
    }

    protected function _getPortableColumnDefinition($tableColumn)
    {
        // 先调用父类方法获取默认的列定义
        $column = parent::_getPortableColumnDefinition($tableColumn);
        
        // 针对可空列，把字符串'NULL'转为原生NULL
        if (!$column->getNotNull() && $column->getDefault() === 'NULL') {
            $column->setDefault(null);
        }
        
        return $column;
    }
}

步骤2：创建SchemaManager工厂类 #

use Doctrine\DBAL\Connection;
use Doctrine\DBAL\Schema\AbstractSchemaManager;
use Doctrine\DBAL\Schema\SchemaManagerFactoryInterface;

class CustomMySQLSchemaManagerFactory implements SchemaManagerFactoryInterface
{
    public function createSchemaManager(Connection $connection): AbstractSchemaManager
    {
        return new CustomMySQLSchemaManager($connection);
    }
}

步骤3：在Doctrine配置中注册 #

如果是Symfony项目，修改config/packages/doctrine.yaml：

doctrine:
    dbal:
        connections:
            default:
                # 你的数据库连接配置...
                schema_manager_factory: 'App\Doctrine\CustomMySQLSchemaManagerFactory'

（如果是其他框架/原生Doctrine使用，只需在Connection配置中指定这个工厂类即可）

3. 临时应急方案（不推荐长期使用） #

如果只是想快速跳过这个问题，可以在执行Doctrine的schema更新命令时加上--force参数，强制同步一次：

php bin/console doctrine:schema:update --force

但这只是临时解决，下次生成schema对比时问题还会出现，仅适合紧急场景。

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