如何在 Laravel 中正确执行多表关联查询以生成 Google 图表数据

本文详解 laravel 中使用 query builder 执行员工培训学时统计查询的正确写法，解决 `innerjoin()` 方法未定义错误，并提供可直接用于 google visualization pie chart 的结构化数据返回方案。

在 Laravel 中，Illuminate\Database\Query\Builder 并不提供 innerJoin() 方法——它只提供统一的 join() 方法，默认即为 INNER JOIN。你遇到的 Call to undefined method Illuminate\Database\Query\Builder::innerJoin() 错误，正是因为误用了不存在的方法名。

✅ 正确做法是使用 ->join()，并传入关联字段（推荐显式写法），而非闭包形式（除非需复杂条件）。同时，原 SQL 中嵌套子查询计算 TotalTrainingHours 会导致每行重复执行，性能低下且易出错；更高效、更 Laravel 的方式是使用 LEFT JOIN + GROUP BY 配合聚合函数：

use Illuminate\Support\Facades\DB;

public function index()
{
    $data = DB::table('employees')
        ->leftJoin('training_hours', 'training_hours.employee_id', '=', 'employees.id')
        ->select(
            'employees.id',
            'employees.first_name',
            DB::raw('COALESCE(SUM(train
ing_hours.hours), 0) as total_training_hours'),
            DB::raw('employees.traininghoursrequired - COALESCE(SUM(training_hours.hours), 0) as training_hours_remaining')
        )
        ->groupBy('employees.id', 'employees.first_name', 'employees.traininghoursrequired')
        ->get();

    // 转换为 Google Charts 兼容的二维数组（含表头）
    $chartData = $data->map(function ($row) {
        return [
            $row->first_name,
            (int) $row->total_training_hours,
            (int) $row->training_hours_remaining
        ];
    })->values()->toArray();

    // 示例：返回 JSON 供前端 JS 调用（如 fetch）
    return response()->json([
        'status' => 'success',
        'data' => $chartData,
        'columns' => ['Employee', 'Completed Hours', 'Remaining Hours']
    ]);
}

? 关键注意事项：

• 使用 leftJoin() 而非 join() 可确保即使某员工暂无培训记录（training_hours 表中无匹配行），仍会出现在结果中，避免数据丢失；
• COALESCE(SUM(...), 0) 防止 NULL 求和导致整行计算失败；
• 必须 ->groupBy() 所有非聚合字段（Laravel 8+ 默认启用严格模式）；
• 若需在 Blade 中直接渲染图表，可将 $data 传入视图，并用 json_encode() 输出至
• Google Visualization Pie Chart 接收的数据格式为二维数组，首行为列名（可选），后续为数值行，建议服务端统一转换再返回。

? 进阶建议： 将该逻辑封装为 Eloquent 关系（如在 Employee 模型中定义 trainingHours() hasMany 关系），再配合 withSum()（Laravel 9.21+）进一步简化代码：

// Employee.php 模型中
protected $appends = ['total_training_hours', 'training_hours_remaining'];

public function trainingHours()
{
    return $this->hasMany(TrainingHour::class, 'employee_id');
}

// 控制器中（更语义化）
$employees = Employee::withSum('trainingHours', 'hours')
    ->get()
    ->map(fn($e) => [
        $e->first_name,
        (int) $e->training_hours_sum,
        (int) ($e->traininghoursrequired - $e->training_hours_sum)
    ]);

这样既提升可读性与可维护性，也天然规避原始 SQL 写法中的语法与逻辑风险。

# ai  # 可选  # 出现在  # google  # 进阶  # 如在  # 可将  # 不存在  # 而非  # 可直接  # app  # js  # json  # go  # red  # 数据丢失  # NULL  # 前端  # 封装  # cad  # php  # 闭包  # sql  # 转换为  # undefined  # laravel  # database  # 严格模式  # 聚合函数  # 暂无 

相关栏目： <？ｍｕｍａ $count = M('archives')->where(['typeid'=>$field['id']])->count(); ?> 【 AI推广<？ｍｕｍａ echo $count; ?> 】 <？ｍｕｍａ $count = M('archives')->where(['typeid'=>$field['id']])->count(); ?> 【 SEO优化<？ｍｕｍａ echo $count; ?> 】 <？ｍｕｍａ $count = M('archives')->where(['typeid'=>$field['id']])->count(); ?> 【 技术百科<？ｍｕｍａ echo $count; ?> 】 <？ｍｕｍａ $count = M('archives')->where(['typeid'=>$field['id']])->count(); ?> 【 谷歌推广<？ｍｕｍａ echo $count; ?> 】 <？ｍｕｍａ $count = M('archives')->where(['typeid'=>$field['id']])->count(); ?> 【 百度推广<？ｍｕｍａ echo $count; ?> 】 <？ｍｕｍａ $count = M('archives')->where(['typeid'=>$field['id']])->count(); ?> 【 网络营销<？ｍｕｍａ echo $count; ?> 】 <？ｍｕｍａ $count = M('archives')->where(['typeid'=>$field['id']])->count(); ?> 【 案例网站<？ｍｕｍａ echo $count; ?> 】 <？ｍｕｍａ $count = M('archives')->where(['typeid'=>$field['id']])->count(); ?> 【 精选文章<？ｍｕｍａ echo $count; ?> 】