CakePHP 3.3升级至4.4后出现SQL字段无默认值错误的问题排查

Hi，我来帮你捋清楚这个问题～

你遇到的SQLSTATE[HY000]: General error: 1364 Field 'cert_request' doesn't have a default value错误，本质是CakePHP 4.x和3.x在实体字段赋值逻辑上的行为差异，加上数据库字段本身没有设置默认值导致的。

为什么升级后突然出现这个问题？ #

在CakePHP 3.3中，当你用patchEntity处理提交的数据时，对于那些在validation里标记为allowEmptyString的字段，如果$data里没有包含它们，框架会自动帮你填充为空字符串，所以数据库不会收到NULL值。但到了CakePHP 4.x，这个行为被调整了——框架会更严格地遵循“只提交什么就赋值什么”的规则，未出现在$data里的字段不会被自动设置为空字符串，而是保持null或者干脆不传递给数据库。而你的数据库里这些字段是NOT NULL且没有默认值，所以数据库就会抛出这个错误。

更优雅的解决方案（替代你目前的hack写法） #

下面几种方法都比在Controller里手动补空字符串更符合CakePHP的最佳实践：

1. 从数据库层面彻底解决（推荐）

直接给这些字段设置默认值为空字符串，这样不管框架传不传值，数据库都会自动填充：

ALTER TABLE certs MODIFY COLUMN cert_request VARCHAR(255) DEFAULT '' NOT NULL;
ALTER TABLE certs MODIFY COLUMN ip_address VARCHAR(255) DEFAULT '' NOT NULL;

根据字段实际类型调整VARCHAR(255)，比如如果是TEXT类型就改成TEXT DEFAULT '' NOT NULL。

2. 在实体类中设置默认值

如果不想修改数据库，可以在App\Model\Entity\Cert.php中给这些字段设置默认值，新建实体时会自动生效：

namespace App\Model\Entity;

use Cake\ORM\Entity;

class Cert extends Entity
{
    // 确保字段是可赋值的
    protected $_accessible = [
        // 其他已有的可访问字段...
        'cert_request' => true,
        'ip_address' => true,
        // 其他字段...
    ];

    protected function _initializeFields()
    {
        parent::_initializeFields();
        // 给字段设置默认空字符串，如果原本没有值的话
        $this->set('cert_request', $this->get('cert_request') ?? '');
        $this->set('ip_address', $this->get('ip_address') ?? '');
    }
}

3. 在Table类的beforeSave回调中统一处理

在CertsTable里添加beforeSave方法，在保存实体前检查并补全空值：

// 在CertsTable类中添加
public function beforeSave(\Cake\Event\EventInterface $event, \Cake\Datasource\EntityInterface $entity, \ArrayObject $options)
{
    // 只针对新建的实体处理（如果编辑时也需要可以去掉isNew判断）
    if ($entity->isNew()) {
        $entity->set('cert_request', $entity->get('cert_request') ?? '');
        $entity->set('ip_address', $entity->get('ip_address') ?? '');
    }
    
    return true;
}

为什么你的hack写法不够好？ #

虽然手动给$data补空字符串能解决问题，但如果后续还有其他类似字段，你需要在每个Controller的保存逻辑里重复写判断，维护成本很高。上面的方法要么从根源解决（数据库默认值），要么在模型层统一处理，更符合MVC的分层思想。

备注：内容来源于stack exchange，提问作者U_plus_200B