插入失败主因是权限、字符集、SQL语法或字段约束问题,需优先检查mysqli_error()或PDO::errorInfo()错误信息,再核对表结构、字符集及SQL拼接。
数据库连得上但插入失败,大概率不是连接问题,而是权限、字符集、SQL 语法、事务或字段约束在暗处卡住——先别急着重写代码,按顺序排查这四类点最省时间。
mysqli_error() 或 PDO::errorInfo() 返回的具体错误信息连得上不等于操作成功,PHP 的 MySQL 扩展默认不抛异常,必须主动查错。很多开发者只看 mysqli_query() 返回 false 就停了,没读错误内容,结果把“字段长度超限”当成“连不上库”反复调连接参数。
mysqli 时,紧接在 query() 后加 echo mysqli_error($conn);
PDO 时,执行失败后调 $pdo->errorInfo(),第二项 [1] 是 MySQL 错误码,第三项 [2] 是原生提示,比如 "Data too long for column 'name' at row 1"
PDO::ATTR_ERRMODE => PDO::ERRMODE_SILENT,errorInfo() 才有效;设成 EXCEPTION 模式会直接抛异常,反而更易定位插入语句看着没问题,但数据库层面有隐性拦截。比如字段定义为 NOT NULL 却没给值,MySQL 5.7+ 默认拒绝插入(严格模式),而旧版本可能静默转成空字符串或 0,行为不一致。
DESCRIBE table_name; 看字段的 Null 列和 Default 列UNIQUE 索引字段重复(比如邮箱已存在),错误码通常是 1062
"Cannot add or update a child row",说明关联主表里没对应记录INSERT INTO t (a) VALUES ('x') 对 INT 字段插入字符串,MySQL 可能转成 0 并警告——开 STRICT_TRANS_TABLES 模式会让这类操作直接报错连库时指定了 utf8mb4,但表或字段仍是 utf8(实际是 utf8mb3),插入 emoji 或某些生僻字就会被截断,甚至整条语句失败,错误提示可能是 "Incorrect string value"(错误码 1366)。
SET NAMES utf8mb4(mysqli)或在 DSN 中加 ;charset=utf8mb4(PDO)SHOW CREATE TABLE table_name 确认表字符集是 utf8mb4,且排序规则是 utf8mb4_unicode_ci 或类似utf8,即使连库设对了也没用mb_strlen($str, 'utf8') 测字符串长度没问题,不代表 MySQL 能存——得看它实际占多少字节(emoji 占 4 字节,utf8 字段最多存 3 字节)肉眼看着正常的 SQL,粘贴到 MySQL 客户端里一跑就错,常见原因是 PHP 字符串拼接引入不可见字符,或用户输入带单引号没处理。
echo $sql; 或 var_dump($sql),复制出来直接在 phpMyAdmin 或命令行执行,看是否复现mysqli_prepare /
PDO::prepare),而不是 "INSERT INTO t VALUES ('$val')"
mysqli_real_escape_string($conn, $input);但注意该函数依赖有效连接,不能在 mysqli_connect() 失败后调用EF BB BF
真正难缠的往往不是连接失败,而是错误被吞掉、提示被忽略、或字段约束在迁移中悄悄变了。每次插入失败,先抓 errorInfo() 或 mysqli_error() 输出,再比对表结构和字符集,比重装扩展快得多。