本文详解 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(training_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 写法中的语法与逻辑风险。
