CakePHP 4 表单粘贴文本提交触发SQLSTATE[HY000]错误求助

这个问题我之前帮人排查过，核心原因是你粘贴的文本里包含了特殊Unicode字符（比如错误提示里的\xE2\x80\x80是EN SPACE，一种非标准空格），而你的数据库字段description的字符集或CakePHP的数据库配置没跟上，导致无法存储这类字符。下面是具体的解决步骤：

1. 检查并修改数据库字段的字符集 #

旧的utf8字符集只支持3字节的Unicode字符，像这类特殊空格、emoji等都是4字节字符，必须用utf8mb4才能存储。

• 直接用SQL命令修改字段：

  ALTER TABLE your_table MODIFY COLUMN description TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  

  注意把your_table换成你的实际表名。
• 如果你用CakePHP的迁移文件管理数据库结构，可以在迁移里这样定义：

  $this->table('your_table')
      ->changeColumn('description', 'text', [
          'collation' => 'utf8mb4_unicode_ci',
          'charset' => 'utf8mb4',
          'null' => true,
      ])
      ->update();
  

2. 修正CakePHP的数据库连接配置 #

确保你的数据库连接已经指定了utf8mb4编码，打开config/app_local.php，找到Datasources里的默认连接，添加编码配置：

'Datasources' => [
    'default' => [
        'host' => 'localhost',
        'username' => 'your_username',
        'password' => 'your_password',
        'database' => 'your_database',
        'encoding' => 'utf8mb4', // 新增这一行
        'timezone' => 'UTC',
        // 其他原有配置...
    ],
]

3. 可选：过滤提交文本中的特殊字符 #

如果你不想存储这类特殊字符，可以在实体的beforeSave钩子中过滤掉它们，比如：

// 在对应的Entity类（比如src/Model/Entity/YourEntity.php）里添加
use Cake\Event\EventInterface;
use ArrayObject;

public function beforeSave(EventInterface $event, ArrayObject $options)
{
    if (!empty($this->description)) {
        // 替换各种特殊空格为普通空格，你可以调整正则匹配范围
        $this->description = preg_replace('/[\x{2000}-\x{200F}]/u', ' ', $this->description);
        // 也可以直接移除所有非打印字符：preg_replace('/[^\P{C}]/u', '', $this->description);
    }
}

这样处理后，不管是粘贴特殊字符还是正常文本，都能顺利提交到数据库了。

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