fastadmin对接人大金仓 kingbase问题记录&解决

问题描述

在 FastAdmin 对接 Kingbase 数据库时，遇到以下错误：

1. miss update condition 错误
2. property not exists:app\\admin\\model\\cms\\Block->id 错误
3. 导入数据库后需要修改序列

解决 miss update condition 错误

该错误通常是由于模型更新操作缺少条件导致。在 FastAdmin 中，更新操作必须指定条件，否则会抛出此错误。

检查模型中是否存在类似以下代码：

$model->where('id', $id)->update($data);

框架中大部分更新操作都是查询出来row，最row->save()，这样是不行的，一定要写 where 条件。

确保更新操作始终包含条件，例如 where 子句。

解决 property not exists 错误

错误提示 property not exists:app\\admin\\model\\cms\\Block->id 表明模型 Block 中缺少 id 属性定义。

在模型文件中添加 id 属性：

namespace app\admin\model\cms;

use think\Model;

class Block extends Model
{
    protected $pk = 'id'; // 指定主键字段
}

确保数据库表中有 id 字段，并且模型正确指定了主键。

导入数据库后修改序列

Kingbase 使用序列（Sequence）来管理自增字段。导入数据后，序列可能不会自动更新，导致后续插入操作出现主键冲突。

手动更新序列：

-- 假设表名为 fa_block，主键为 id
SELECT setval('fa_block_id_seq', (SELECT MAX(id) FROM fa_block));

如果序列名称不确定，可以通过以下命令查看：

SELECT pg_get_serial_sequence('fa_block', 'id');

其他注意事项

确保 Kingbase 的配置正确，在 config/database.php 中配置如下：

'connections' => [
    'kingbase' => [
        'type' => 'pgsql', // Kingbase 兼容 PostgreSQL 协议
        'hostname' => '127.0.0.1',
        'database' => 'database_name',
        'username' => 'username',
        'password' => 'password',
        'hostport' => '54321', // Kingbase 默认端口
        'charset' => 'utf8',
        'prefix' => 'fa_',
    ],
]

验证解决方案

完成上述修改后，测试以下功能：

1. 数据插入和更新操作是否正常
2. 主键自增是否正常工作
3. 模型属性访问是否无报错

问题如果问题仍然存在，检查数据库日志和 FastAdmin 的调试日志，进一步定位问题原因。