Laravel 8项目报错：Attempt to read property 'customer' on null等问题求助

问题说明 #

调用VehicleController的show方法时触发两个错误：

1. Attempt to read property 'customer' on null
2. Property [full_name] does not exist on this collection instance

已尝试空合并运算符处理，未解决，以下是相关代码模块及排查方案：

相关代码示例 #

Vehicle 模型

// 示例代码，需替换为实际代码
namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Vehicle extends Model
{
    protected $fillable = ['plate_number', 'customer_id'];

    // 此处为关联定义，是问题排查关键
    public function customer()
    {
        return $this->belongsTo(Customer::class);
        // 若误写为hasMany则会引发集合错误
    }
}

Customer 模型

// 示例代码，需替换为实际代码
namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Customer extends Model
{
    protected $fillable = ['first_name', 'last_name'];

    // 若使用访问器生成full_name，需确保定义正确
    public function getFullNameAttribute()
    {
        return $this->first_name . ' ' . $this->last_name;
    }
}

VehicleController 的 show 方法

// 示例代码，需替换为实际代码
namespace App\Http\Controllers;

use App\Models\Vehicle;
use Illuminate\Http\Request;

class VehicleController extends Controller
{
    public function show($id)
    {
        // 错误写法：find()找不到时返回null，导致后续调用customer报错
        // $vehicle = Vehicle::find($id);
        
        // 正确写法：找不到时直接返回404，确保$vehicle不为null
        $vehicle = Vehicle::with('customer')->findOrFail($id);
        
        return view('vehicles.show', compact('vehicle'));
    }
}

视图代码（vehicles/show.blade.php）

<!-- 错误写法1：未判断$vehicle是否存在 -->
<p>客户姓名：{{ $vehicle->customer->full_name }}</p>

<!-- 错误写法2：若customer是集合，直接访问full_name报错 -->
<p>客户姓名：{{ $vehicle->customer->full_name }}</p>

<!-- 正确写法1：空安全运算符+集合判断 -->
<p>客户姓名：{{ $vehicle?->customer?->full_name ?? '无关联客户' }}</p>

<!-- 正确写法2：若customer是一对多集合，需循环遍历 -->
@if($vehicle?->customer->isNotEmpty())
    @foreach($vehicle->customer as $customer)
        <p>客户姓名：{{ $customer->full_name }}</p>
    @endforeach
@else
    <p>无关联客户</p>
@endif

错误排查与解决 #

错误1：Attempt to read property 'customer' on null #

• 核心原因：控制器中未找到对应ID的车辆，$vehicle为null，却直接访问其customer关联
• 解决：
  1. 控制器中改用findOrFail()替代find()，找不到车辆时直接返回404页面，确保$vehicle必为有效模型实例
  2. 视图中添加空安全判断，用$vehicle?->customer替代$vehicle->customer，避免null调用属性

错误2：Property [full_name] does not exist on this collection instance #

• 核心原因：Vehicle模型中customer关联被错误定义为hasMany()（一对多），导致返回的是集合而非单个客户模型，集合没有full_name属性
• 解决：
  1. 检查Vehicle模型的关联定义，确保是belongsTo()（一辆车属于一个客户）
  2. 若业务确实需要一辆车对应多个客户，视图中需循环遍历customer集合，逐个访问full_name

额外验证项 #

• 确认vehicles表存在customer_id字段，且已正确设置外键关联到customers表主键
• 确认Customer模型中存在full_name字段，或已正确定义getFullNameAttribute访问器

内容的提问来源于stack exchange，提问作者Jon.M DEV CAX