Laravel中如何将SheetDB获取的Sheets数据存入MySQL表

现有代码的问题点 #

• 调试语句dd($result)写在数据库插入逻辑之前，执行到该行会直接终止程序运行，后续循环插入的代码完全不会执行。
• 取值方式错误：SheetDB官方PHP SDK的get()方法默认返回关联数组结构的结果集，并非对象数组，原代码用$row->name的对象式取值会直接报错。
• 缺少字段校验：没有判断返回结果中是否存在对应字段，遇到空行、字段名不匹配的情况会抛出异常。
• 插入效率低：单条循环insert会产生大量数据库请求，数据量稍大时执行速度极慢。
• 缺少时间戳赋值：用DB::table()的insert方法批量插入时，不会自动给created_at、updated_at字段赋值，会导致这两个字段为空。

前置准备确认 #

• 已经通过Composer安装SheetDB SDK：执行命令composer require sheetdb/sheetdb-php
• 已经执行数据库迁移，DbSheets表在对应MySQL库中创建成功
• 使用的SheetDB API密钥拥有目标表格的读取权限
• 对应Google Sheet的第一行为字段名，且存在name列，列名无多余空格、大小写匹配

注意：Google Sheet中修改列名后，SheetDB API返回的字段名会同步变更，需要同步调整代码中的字段映射关系。

修正后的可运行代码 #

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use DB;
use SheetDB\SheetDB;
use App\Http\Controllers\Controller;

class SheetdbController extends Controller
{
    public function get()
    {
        // 初始化SheetDB客户端
        $sheetdb = new SheetDB('5wwy7qkrnqxt1');
        $sheetRows = $sheetdb->get();
        
        if (empty($sheetRows)) {
            return response()->json(['status' => 'fail', 'msg' => '未从SheetDB获取到有效数据']);
        }

        $insertData = [];
        $currentTime = now();
        foreach ($sheetRows as $row) {
            // 过滤掉name字段不存在的空行
            if (!isset($row['name']) || trim($row['name']) === '') {
                continue;
            }
            // 组装待插入数据，手动填充时间戳
            $insertData[] = [
                'name' => trim($row['name']),
                'created_at' => $currentTime,
                'updated_at' => $currentTime
            ];
        }

        if (!empty($insertData)) {
            // 批量插入，性能比单条循环插入高数十倍
            DB::table('DbSheets')->insert($insertData);
        }

        return response()->json([
            'status' => 'success',
            'msg' => '数据同步完成',
            'insert_count' => count($insertData)
        ]);
    }
}

可选优化建议 #

• 重复数据过滤：如果业务要求name字段唯一，可以在插入前先查询DbSheets表中已存在的name值，过滤重复数据后再执行插入，避免脏数据。
• 异步执行：如果单表数据量超过1000条，建议将同步逻辑封装为Laravel队列任务异步执行，避免HTTP请求超时。
• 异常捕获：可以用try-catch包裹SheetDB请求、数据库插入逻辑，将异常信息写入日志，方便后续排查问题。
• 增量同步：如果是定时同步场景，可以给DbSheets表加对应Sheet行id的唯一标识，每次只拉取上次同步时间后更新的数据，减少重复请求和插入。

常见问题排查 #

• 报类不存在错误：执行composer dump-autoload重载Composer自动加载文件即可。
• 报未定义索引name错误：先打印$sheetRows查看返回的字段名，确认Google Sheet第一行的name列没有多余空格、大小写和代码中一致。
• 接口返回插入成功但表中无数据：检查.env中的数据库连接配置，确认当前连接的是目标MySQL库，没有连错测试/生产环境。

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