Laravel表单批量提交成功但无数据入库问题排查

1. 检查表单字段命名格式 #

循环生成的表格表单必须使用数组格式命名字段，否则后端无法正确接收批量数据。正确的表单字段写法示例：

@foreach($items as $index => $item)
    <tr>
        <td><input type="text" name="entries[{{ $index }}][value]"></td>
        <td><input type="checkbox" name="entries[{{ $index }}][is_active]" value="1"></td>
        <td><input type="hidden" name="entries[{{ $index }}][target_id]" value="{{ $item->target_id }}"></td>
        <td><input type="hidden" name="entries[{{ $index }}][period_id]" value="{{ $periodId }}"></td>
    </tr>
@endforeach

若字段未采用entries[][xxx]或entries[$index][xxx]的数组结构，后端仅能获取单个值，无法批量处理数据。

2. 验证后端请求数据接收情况 #

在Controller的提交方法中临时打印请求内容，确认数据是否完整传递：

public function store(Request $request)
{
    // 临时打印请求数据，排查接收是否正常
    dd($request->all());
    
    // 原业务代码...
}

若输出结果中无entries数组，或数组内字段缺失，说明表单字段命名存在问题。

3. 检查模型批量赋值权限 #

确保对应Model（如TargetEntry）已将需入库字段添加至$fillable属性：

class TargetEntry extends Model
{
    protected $fillable = [
        'value',
        'is_active',
        'target_id',
        'period_id'
    ];
}

若字段不在$fillable列表中，Laravel的批量赋值保护会阻止数据写入，且无明显报错提示。

4. 排查Service层入库逻辑 #

检查Service中的保存代码，确认批量数据处理逻辑正确：

• 单条循环保存时，需确保每个条目调用save()：

public function saveEntries($entries)
{
    foreach ($entries as $entryData) {
        // 过滤不完整数据
        if (empty($entryData['value']) || empty($entryData['target_id']) || empty($entryData['period_id'])) {
            continue;
        }
        $entry = new TargetEntry();
        $entry->fill($entryData);
        $entry->save(); // 必须调用save()才会写入数据库
    }
}

• 批量插入时，使用insert()方法：

public function saveEntries($entries)
{
    // 过滤无效数据
    $validEntries = array_filter($entries, function($item) {
        return isset($item['value'], $item['target_id'], $item['period_id']);
    });
    
    TargetEntry::insert($validEntries); // 批量插入操作
}

注：insert()不会触发模型事件，需确保所有字段在$fillable中。

5. 检查事务处理是否正常提交 #

若Service中使用了数据库事务，需确认未触发隐式回滚：

public function saveEntries($entries)
{
    DB::beginTransaction();
    try {
        foreach ($entries as $entryData) {
            TargetEntry::create($entryData);
        }
        DB::commit(); // 必须提交事务，否则数据不会写入
    } catch (\Exception $e) {
        DB::rollBack();
        // 需抛出异常或返回错误，避免前端收到成功提示但实际数据回滚
        throw $e;
    }
}

若事务内出现异常但未抛出，前端会收到成功响应，但数据库实际已回滚数据。

6. 检查数据库外键约束 #

确认target_id和period_id对应的关联表中存在有效ID，外键约束会导致插入失败。可查看Laravel日志文件（storage/logs/laravel.log），排查是否存在外键约束错误。

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