插入失败主因是权限、字符集、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、UNIQUE、外键或默认值逻辑
插入语句看着没问题，但数据库层面有隐性拦截。比如字段定义为 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，即使连库设对了也没用 - PHP 中用
mb_strlen($str, 'utf8')测字符串长度没问题，不代表 MySQL 能存——得看它实际占多少字节（emoji 占 4 字节，utf8字段最多存 3 字节）
验证 SQL 语句是否被意外拼接出空格、换行或未转义单引号
肉眼看着正常的 SQL，粘贴到 MySQL 客户端里一跑就错，常见原因是 PHP 字符串拼接引入不可见字符，或用户输入带单引号没处理。
- 打印完整 SQL：用
echo $sql;或var_dump($sql)，复制出来直接在 phpMyAdmin 或命令行执行，看是否复现 - 避免
手动拼接：优先用预处理（
mysqli_prepare/PDO::prepare），而不是"INSERT INTO t VALUES ('$val')" - 如果非用拼接，至少过一遍
mysqli_real_escape_string($conn, $input)；但注意该函数依赖有效连接，不能在mysqli_connect()失败后调用 - 检查是否有 BOM 头或 IDE 自动插入的全角空格——把 SQL 复制进十六进制编辑器看开头是不是
EF BB BF
真正难缠的往往不是连接失败，而是错误被吞掉、提示被忽略、或字段约束在迁移中悄悄变了。每次插入失败，先抓 errorInfo() 或 mysqli_error() 输出，再比对表结构和字符集，比重装扩展快得多。
