PHP使用MySQLi预处理插入后insert_id返回null的异常排查

问题现状 #

• 采用mysqli预处理流程执行INSERT语句，实际可完成数据落盘，但通过$sql->insert_id读取自增ID时，始终返回空值/未定义值
• 现有兜底方案为单独查询MAX(VesselTransitID)获取最大值，该逻辑在并发写入场景下无法保证ID与本次插入记录的对应关系，存在生产级风险
• 核心实现代码：

$sql = $this->dbLink->prepare("
            INSERT INTO VesselTransits (CreatedByUserID, TerminalID, VesselArrivalDate, VesselNameID)
            VALUES (?,?,?,?)
    ");
//i=integer, s=string
$sql->bind_param('iisi', $userID, $terminalID, $arrivalDate, $vesselNameID);
$userID          = $this->invoiceData['userID'];
$terminalID      = $this->invoiceData['terminalID'];
$arrivalDate     = date('Y-m-d', strtotime($this->invoiceData['berthDate']));
$vesselNameID    = $this->invoiceData['vesselNameID'];
$sql->execute();
$vesselTransitID = $sql->insert_id;
return($vesselTransitID);

• 对应表结构定义：

CreatedByUserID   int
CreationDate      datetime
ModifiedByUser    int
ModifyDate        datetime
TerminalID        int
VesselArrivalDate datetime
VesselNameID      int
VesselTransitID   int [auto_increment]

异常触发根因 #

• PHP版本兼容断层：PHP 7.4及以上版本中，mysqli_stmt预处理对象才内置insert_id属性。如果运行环境版本低于7.4，直接访问$sql->insert_id本质是读取一个对象上不存在的属性，必然返回未定义空值，与INSERT是否执行成功无关。
• 表结构配置不符合MySQL自增返回规则：MySQL要求带auto_increment属性的字段必须同时是表的主键或唯一索引，否则插入记录时生成的自增值不会写入当前会话的3386283状态。此时哪怕插入流程完全正常，读取自增ID也会返回0或空值。
• 错误静默掩盖真实执行状态：默认mysqli扩展会将SQL错误写入日志，不会主动抛出异常。很多场景下“插入成功”只是表象，实际可能因为字段类型不匹配、权限不足、SQL模式拦截非法值等原因，语句根本未执行到自增ID生成环节，残留的空值会被误认为插入完成。
• 跨操作覆盖会话状态：如果在预处理执行和读取insert_id的间隙，当前连接又执行了其他带自增插入的SQL，insert_id会被后续操作覆盖，返回非本次插入的ID值。

可靠修正方案 #

1. 初始化脚本阶段开启mysqli异常上报，避免错误被静默掩盖：

   mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
   

2. 调整自增ID的读取来源，从数据库连接对象读取，实现全PHP版本兼容：
   • 连接对象的insert_id属性从mysqli扩展诞生起就内置支持，是MySQL原生3386283的封装，会话级绑定当前连接的最近一次插入自增值，完全没有并发读取冲突
   • 摒弃从预处理对象读取insert_id的写法，避免旧版本兼容问题
3. 检查VesselTransitID字段的索引配置，确保其为表的主键，满足MySQL自增ID返回的前置要求

修正后的核心代码：

// 预处理语句定义
$sql = $this->dbLink->prepare("
    INSERT INTO VesselTransits (CreatedByUserID, TerminalID, VesselArrivalDate, VesselNameID)
    VALUES (?,?,?,?)
");
// 绑定参数：类型串需与占位符顺序严格匹配
$sql->bind_param(
    'iisi',
    $userID,
    $terminalID,
    $arrivalDate,
    $vesselNameID
);
// 变量赋值（bind_param基于引用传值，赋值时机不影响execute执行结果）
$userID          = $this->invoiceData['userID'];
$terminalID      = $this->invoiceData['terminalID'];
$arrivalDate     = date('Y-m-d', strtotime($this->invoiceData['berthDate']));
$vesselNameID    = $this->invoiceData['vesselNameID'];

$sql->execute();
// 从连接对象读取自增ID，兼容所有PHP版本
$vesselTransitID = $this->dbLink->insert_id;

return $vesselTransitID;

注意：绝对禁止使用MAX(自增字段)的兜底方案，该值是全表全局最大值，高并发下极容易拿到其他并发请求生成的ID，导致业务关联错乱。数据库封装的insert_id是会话级隔离的，不存在并发干扰问题。

内容的提问来源于stack exchange，提问作者dneimeier