单条数据插入报错主因是字段映射错位、字符集不匹配或安全过滤干扰；需检查表单键名与数据库列名是否严格一致、关闭XSS过滤对比空值、设utf8mb4字符集、用显式数组插入并校验类型、通过$db->error()查具体错误及数据库约束冲突。
单条数据插入报错，多数不是语法错误，而是字段映射错位、字符集不匹配或安全过滤干扰所致。关键不是“重试插入”，而是先确认数据是否完整到达、是否被截断、是否被过滤成空值。
检查表单字段名与数据库列名是否严格一致
CI 的 $this->db->insert() 会把 POST 数组的键直接当列名用。若表单中写 name="img_url"，而数据库列是 image_path，就会因列不存在报错（如 “Unknown column 'img_url'”）。
- 打开浏览器开发者工具 → Network → 查看提交的 Form Data，确认键名拼写、大小写、下划线是否与数据库字段完全一致
- 数据库字段含前缀（如
tbl_）时，表单名也需对应；反之，若数据库用user_name，表单就不能写username - 避免使用 PHP 保留字作字段名（如
order、group），必须用则需在模型中显式声明或加反引号（CI3 中可配合$this->db->escape()处理）
验证输入数据是否为空或被 XSS 过滤清空
启用 TRUE 参数做 XSS 过滤时，某些富文本内容（如含 script 标签的描述）可能被整段删掉，导致关键字段变 NULL，而该字段在数据库设为 NOT NULL 就会插入失败。
- 临时关闭过滤调试：
$this->input->post('Title')（不带 TRUE）对比$this->input->post('Title', TRUE)输出，看是否为空 - 对必填字段做空值校验：
if (empty($this->input->post('Title'))) { show_error('标题不能为空'); } - 中文插入报错（如
Incorrect string value）大概率是字符集问题：确保database.php中'char_set' => 'utf8mb4'，且数据库表及字段 Collation 设为utf8mb4_unicode_ci
使用显式数组插入，避开自动映射陷阱
全自动 $this->db->insert('table', $this->input->post()) 看似简洁，但一旦 POST 包含非法字段（如 submit、csrf_token）、空字段或类型不匹配字段（如字符串写进 INT 列），就容易静默失败或报错。
- 推荐写法（CI3）：
$data = [
'Image' => $this->input->post('Image', TRUE),
'Title' => trim($this->input->post('Title', TRUE)),
'Description'=> $this->input->post('Description', TRUE),
'Qty' => (int) $this->input->post('Qty'),
'Price' => (float) $this->input->post('Price'),
'Date' => $this->input->post('Date') ?: date('Y-m-d')
];
if ($this->db->insert('filedata', $data)) {
echo "插入成功";
} else {
log_message('error', 'Insert failed: ' . print_r($this->db->error(), TRUE));
}
- CI4 推荐走 Model：
$model->insert($data)，前提是模型中已定义$allowedFields白名单，否则会被拒绝 - 插入后立即查错：
$this->db->error()返回数组['code' => xxx, 'message' => 'xxx']，比单纯判断布尔值更准
排查数据库层面约束冲突
插入失败常因主键重复、唯一索引冲突、外键缺失或字段长度超限，这类错误 CI 默认不抛异常，只返回 FALSE。
- 检查数据库表结构：
DESCRIBE filedata;确认Image字段是否设为VARCHAR(255)却传入了 300 字符路径 - 查看 MySQL 错误日志（或
$this->db->error()消息），重点识别关键词：Duplicate entry（主键/唯一键冲突）、Data too long（长度超限）、Cannot add or update a child row（外键约束） - 临时放宽约束测试：把
NOT NULL字段改为允许 NULL，插入成功后再逐步收紧，定位具体哪一列出问题
