插入语句错误怎么排查

“插入语句错误”通常指执行 INSERT 语句（如 SQL、MongoDB、Elasticsearch 等）时失败。下面以最常见的 SQL 插入错误为主，系统性讲一下排查思路，最后补充其他场景。

一、先看错误信息（最重要）

绝大多数错误数据库都会返回明确提示，例如：

• Column count doesn't match value count
• Duplicate entry 'x' for key 'PRIMARY'
• Unknown column 'xxx' in 'field list'
• Data too long for column 'xxx'
• Cannot add or update a child row: foreign key constraint fails

✅ 第一步：复制完整报错信息，逐字看

二、常见 SQL INSERT 错误及排查方法

1️⃣ 字段数量不匹配

INSERT INTO user VALUES (1, 'Tom');
-- 表有 3 列，但只给了 2 个值

✅ 解决：

• 明确写字段名

INSERT INTO user(id, name) VALUES (1, 'Tom');

2️⃣ 字段名写错

INSERT INTO user(nam) VALUES ('Tom');

✅ 排查：

DESC user;

确认字段拼写、大小写（MySQL 不区分，Oracle 区分）

3️⃣ 主键 / 唯一键冲突

Duplicate entry '1' for key 'PRIMARY'

✅ 解决：

• 换主键值
• 或用 INSERT IGNORE / ON DUPLICATE KEY UPDATE

4️⃣ 数据类型不匹配

INSERT INTO user(age) VALUES ('abc');

✅ 排查：

DESC user;

确认：

• 数字 / 字符串 / 日期
• 长度限制

5️⃣ 非空字段未赋值

Field 'email' doesn't have a default value

✅ 解决：

• 显式插入
• 或修改表结构允许 NULL

6️⃣ 外键约束失败

foreign key constraint fails

✅ 排查：

• 父表是否存在对应数据
• 外键值是否合法

7️⃣ SQL 语法错误

常见：

• 少了逗号
• 引号不配对
• 用了中文引号

✅ 建议：先简化 SQL，再逐步加字段

三、通用排查流程（推荐）

1. 看报错信息
2. 确认表结构（DESC / SHOW CREATE TABLE）
3. 对比字段和值
4. 单独执行最小 INSERT
5. 检查约束（主键 / 唯一 / 外键 / 非空）
6. 看数据库日志（生产环境）

四、非 SQL 场景简述

MongoDB

• 字段类型错误
• 超过 16MB 文档限制
• 唯一索引冲突

Elasticsearch

• mapping 类型不匹配
• 字段缺失或格式错误

五、如果你愿意

你可以直接把：

• 数据库类型（MySQL / Oracle / PG 等）
• 完整 INSERT 语句
• 报错信息

贴出来，我可以精准帮你定位是哪一行的问题 ✅