表单新增Duration字段提交触发id不能为空PDO异常

在现有业务表单中新增名为Duration的输入字段，且已在数据库对应表中添加同名字段后，提交表单触发致命错误；移除新增的Duration字段及相关代码后，表单可正常提交。

报错信息 #

[Fri Jun 17 09:59:22.955088 2022] [fcgid:warn] mod_fcgid: stderr: PHP Fatal error: Uncaught PDOException: SQLSTATE[23000]: Integrity constraint violation: 1048 Column 'id' cannot be null in /var/www/vhosts/xxx/clients/review/add-review.php:19
错误类型为未捕获的PDO完整性约束异常，提示id字段不允许为空，报错位置为add-review.php第19行的PDO execute调用。

关联代码 #

后端表单处理逻辑 #

<?php
include '../../main.php';
check_loggedin($pdo);
$msg    =   null;
$date = new DateTime();
$totay_date = $date->format('Y-m-d\TH:i:s');
// 校验URL传入的联系人ID
if (isset($_GET['id'])) {
    $stmt = $pdo->prepare('SELECT * FROM contacts WHERE id = ?');
    $stmt->execute([$_GET['id']]);
    $contact = $stmt->fetch(PDO::FETCH_ASSOC);

    // 校验必填POST参数
    if(isset($_POST['date']) == null || isset($_POST['engagement']) == null || isset($_POST['reminder_date']) == null || isset($_POST['care_update']) == null || isset($_POST['review_note']) == null || isset($_POST['duration']) == null){
        $msg    =   '';
    }else{
        $id = isset($_POST['id']) && !empty($_POST['id']) && $_POST['id'] != 'auto' ? $_POST['id'] : NULL;
        // 插入数据SQL
        $stmt = $pdo->prepare('INSERT INTO care_plan_review VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)');
        $result = $stmt->execute([$id, $_GET['id'], $_POST['reminder_date'], $_POST['engagement'], $_POST['care_update'], $_POST['review_note'], $_POST['note'], $_POST['date'], $_POST['amount'], $_POST['duration']]);
        $msg    =   "New Care Plan Entry Added!";
    }

    if (!$contact) {
        exit('Contact doesn\'t exist with that ID!');
    }
} else {
    exit('No ID specified!');
}
?>

新增字段前端代码 #

<div class="form-row">
    <div class="form-group col-md-12">
        <label >Duration*</label>
        <input type="text" name="duration" id="duration" class="form-control"></textarea>
    </div>
</div>

已核对INSERT语句的占位符数量与传入参数数量均为10个，数量匹配。

• 核心原因是插入SQL的写法存在严重隐患：使用INSERT INTO 表名 VALUES (...)语法时未显式指定插入字段，这种写法要求传入参数的顺序必须和数据库表中字段的定义顺序完全一致，一旦表结构变更（新增字段、调整字段顺序）就会出现参数与字段错位的问题。新增duration字段后，传入参数和表实际字段顺序未对齐，导致NULL值被传入非空的id字段，触发约束报错。
• 前端代码存在标签语法错误：duration字段使用的是<input>输入标签，后方错误添加了</textarea>闭合标签，会导致表单DOM结构解析异常，可能加重字段提交的错位问题。

1. 修改插入SQL，显式指定要插入的字段名，从根本上避免字段顺序错位问题，这是最核心的修复项。修改后的SQL示例（字段名请根据care_plan_review表的实际字段名调整，确保和传入参数一一对应）：

   // 显式指定字段顺序，和execute传入的参数顺序严格对应即可，不受表结构字段顺序影响
   $stmt = $pdo->prepare('INSERT INTO care_plan_review (id, contact_id, reminder_date, engagement, care_update, review_note, note, `date`, amount, duration) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)');
   

   优化提示：如果id字段是自增主键，可以直接省略SQL中的id字段和对应传入的$id参数，数据库会自动生成自增ID，不需要手动传NULL。
2. 修复前端标签语法错误，删除<input>标签后多余的</textarea>闭合标签，修正后代码：

   <div class="form-row">
       <div class="form-group col-md-12">
           <label >Duration*</label>
           <input type="text" name="duration" id="duration" class="form-control">
       </div>
   </div>
   

3. 可选逻辑优化：将参数校验的isset($_POST['xxx']) == null写法替换为更直观的!isset($_POST['xxx'])，避免逻辑判断歧义；同时建议将必填字段校验统一封装，减少重复代码。

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