PHP8.1迁移后Yii2的RegistroActividad模型无法保存至表

一、排查数据库隐性错误 #

getErrors()仅返回模型验证阶段的错误，数据库层面的问题（如外键约束、字段不匹配）不会被自动捕获，导致save失败但无错误提示。

• 开启Yii数据库日志定位问题
  在配置文件（如config/web.php或config/db.php）中添加日志配置：

  'components' => [
      'db' => [
          // 原有数据库配置
          'enableLogging' => true,
          'enableProfiling' => true,
      ],
      'log' => [
          'traceLevel' => 3,
          'targets' => [
              [
                  'class' => 'yii\log\FileTarget',
                  'levels' => ['error', 'warning'],
                  'categories' => ['yii\db\*'],
              ],
          ],
      ],
  ]
  

  执行save操作后，查看runtime/logs下的日志文件，找到对应的SQL语句和数据库返回的错误详情。

• 手动执行SQL测试
  提取日志中的插入SQL，直接在MariaDB客户端执行：

  INSERT INTO registro_actividad (usuario_id, ip, fecha_hora, modulo, accion, datos, nivel) VALUES (7, '127.0.1.1', '2023-02-13 17:35:53', 'ticket', 'update', 'hi', 'info');
  

  若执行报错，可直接定位数据库问题（比如外键关联的usuario表不存在id=7的记录、字段长度超限等）。

二、升级Yii2版本适配PHP8.1 #

你当前使用的Yii2版本~2.0.47对PHP8.1的兼容性不足，内部逻辑可能在PHP8.1下抛出隐性错误，导致save失败但未触发模型错误。

修改composer.json中的版本约束：

"yiisoft/yii2": "~2.0.49"

执行composer update yiisoft/yii2完成升级后重新测试。

三、检查模型自定义生命周期方法 #

如果RegistroActividad模型中有beforeSave、beforeValidate等自定义方法，PHP8.1的严格类型检查可能导致方法返回false但未设置错误信息。

打开RegistroActividad.php，检查类似方法：

public function beforeSave($insert)
{
    try {
        // 自定义逻辑
        return parent::beforeSave($insert);
    } catch (\Exception $e) {
        $this->addError(null, $e->getMessage());
        return false;
    }
}

确保方法不会因PHP8.1语法变化（如参数/返回值类型）异常返回false，且异常时正确添加错误信息。

四、排查PHP8.1错误处理设置 #

PHP8.1对错误的处理更严格，部分旧代码的警告可能转为错误，但未被Yii捕获。

• 临时关闭严格类型检查（仅用于排查）
  在入口文件web/index.php顶部添加：

  declare(strict_types=0);
  

  若save成功，说明是类型匹配问题，需检查模型属性的类型声明或赋值逻辑。

• 查看PHP错误日志
  找到服务器上的PHP错误日志（通常在/var/log/php/或对应服务器指定目录），查看执行save操作时是否有未被Yii捕获的致命错误或警告。

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