Laravel多用户类型最佳实践咨询：Agent与Client架构方案

针对你的场景，先逐个分析你列出的方案，再给出官方推荐的最优实现：

方案分析 #

1. 单User模型带大量可空字段 #

不推荐。这种方式会导致数据库冗余，大量空字段违反数据库设计范式，后期新增或修改用户专属字段时，需要频繁改动User表，且业务逻辑会混杂在同一个模型中，维护成本高。

2. 继承User模型实现分表存储 #

你描述的“客户存Users表、代理存另一张表”的方式，不属于Laravel Eloquent支持的继承模式——Eloquent的模型继承默认是单表继承（STI），即所有子类数据存在同一张表中，通过类型字段区分。如果要分表存储，应该用一对一关联而非继承，所以这个方案的实现思路存在偏差。

官方推荐的最佳方案 #

根据Laravel的设计理念和社区实践，推荐两种方案，按需选择：

方案A：单表继承（STI）——适合用户差异较小的场景 #

当Agent和Client的专属字段不多、核心业务逻辑重叠度高时，用单表继承最简洁，且完全兼容Laravel的认证系统。

实现步骤：

1. 修改Users表迁移，添加user_type枚举字段区分用户类型，同时按需添加可空的专属字段：

Schema::create('users', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->string('email')->unique();
    $table->timestamp('email_verified_at')->nullable();
    $table->string('password');
    // 标记用户类型
    $table->enum('user_type', ['agent', 'client'])->default('client');
    // Agent专属可空字段
    $table->string('company_name')->nullable();
    $table->string('business_license')->nullable();
    // Client专属可空字段
    $table->string('shipping_address')->nullable();
    $table->rememberToken();
    $table->timestamps();
});

2. 创建Agent和Client模型，继承User并添加全局作用域过滤类型：

// app/Models/Agent.php
namespace App\Models;

class Agent extends User
{
    protected static function booted()
    {
        // 全局作用域：查询Agent时自动过滤user_type=agent
        static::addGlobalScope('agent', function ($query) {
            $query->where('user_type', 'agent');
        });
    }

    // Agent专属业务方法
    public function assignedOrders()
    {
        return $this->hasMany(Order::class, 'agent_id');
    }
}

// app/Models/Client.php
namespace App\Models;

class Client extends User
{
    protected static function booted()
    {
        static::addGlobalScope('client', function ($query) {
            $query->where('user_type', 'client');
        });
    }

    // Client专属业务方法
    public function orders()
    {
        return $this->hasMany(Order::class, 'client_id');
    }
}

3. 认证与使用：
   Laravel默认的Auth系统可以直接使用，登录后可通过auth()->user()获取用户实例，也可以通过Agent::find($id)或Client::find($id)直接查询对应类型的用户。

方案B：通用User表+专属Profile关联——适合用户差异较大的场景 #

当Agent和Client的专属字段多、业务逻辑差异明显时，用这种方式可以严格遵循数据库范式，避免空字段，扩展性更强。

实现步骤：

1. 创建通用Users表，只存储所有用户共享的字段：

Schema::create('users', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->string('email')->unique();
    $table->timestamp('email_verified_at')->nullable();
    $table->string('password');
    $table->enum('user_type', ['agent', 'client'])->default('client');
    $table->rememberToken();
    $table->timestamps();
});

2. 创建AgentProfiles和ClientProfiles表，存储各自专属信息：

// Agent专属表
Schema::create('agent_profiles', function (Blueprint $table) {
    $table->id();
    $table->foreignId('user_id')->constrained()->onDelete('cascade');
    $table->string('company_name');
    $table->string('business_license');
    $table->string('contact_phone');
    $table->timestamps();
});

// Client专属表
Schema::create('client_profiles', function (Blueprint $table) {
    $table->id();
    $table->foreignId('user_id')->constrained()->onDelete('cascade');
    $table->string('shipping_address');
    $table->string('favorite_category');
    $table->timestamps();
});

3. 在User模型中定义关联：

// app/Models/User.php
namespace App\Models;

use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable
{
    // ... 默认代码

    // 关联AgentProfile
    public function agentProfile()
    {
        return $this->hasOne(AgentProfile::class);
    }

    // 关联ClientProfile
    public function clientProfile()
    {
        return $this->hasOne(ClientProfile::class);
    }

    // 快捷判断用户类型
    public function isAgent()
    {
        return $this->user_type === 'agent';
    }

    public function isClient()
    {
        return $this->user_type === 'client';
    }
}

4. 可选：创建Agent/Client模型简化查询：

// app/Models/Agent.php
namespace App\Models;

class Agent extends User
{
    protected static function booted()
    {
        static::addGlobalScope('agent', function ($query) {
            $query->where('user_type', 'agent')->with('agentProfile');
        });
    }
}

这样查询Agent时会自动加载其专属Profile，使用时直接调用$agent->agentProfile->company_name即可。

总结 #

• 若用户差异小、字段少：选单表继承，实现简单，兼容Laravel认证体系。
• 若用户差异大、字段多：选通用User表+Profile关联，数据库设计更规范，扩展性更强。

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