Laravel+VueJS中使用Snowflake大整数ID的相关技术问题

一、关联查询性能影响问题 #

当你在Laravel模型中设置protected $casts = ['id' => 'string'];时，关联查询的性能几乎不会受到影响，原因如下：

• 数据库中存储Snowflake ID的字段是bigint类型，虽然模型会把id属性转为字符串，但Laravel构建关联查询的where条件时，传递给数据库的是字符串形式的数字。MySQL这类数据库会自动将字符串隐式转换为整数，这个转换过程不会破坏索引的有效性，查询速度和用整数比对几乎没有差别。
• 即使考虑隐式转换的微小开销，实际业务场景中也完全可以忽略，因为数据库对数字字符串的类型转换效率极高，不会成为性能瓶颈。

二、不影响模型及关联的ID转字符串方案 #

推荐以下几种仅在响应阶段转换ID类型的方案，完全不会干扰后端模型逻辑和关联查询：

方案1：API资源统一处理（最推荐） #

Laravel的API Resource专门用于格式化响应数据，不会影响模型本身的运行逻辑。你可以创建一个基础资源类，所有业务资源继承它，统一处理ID转换：

namespace App\Http\Resources;

use Illuminate\Http\Resources\Json\JsonResource;

class BaseResource extends JsonResource
{
    public function toArray($request)
    {
        $data = parent::toArray($request);
        
        // 转换当前模型的ID
        if (isset($data['id'])) {
            $data['id'] = (string) $data['id'];
        }
        
        // 递归处理关联数据中的ID
        foreach ($data as $key => $value) {
            if (is_array($value) && isset($value['id'])) {
                $data[$key]['id'] = (string) $value['id'];
            }
        }
        
        return $data;
    }
}

业务资源示例（如用户资源）：

class UserResource extends BaseResource
{
    public function toArray($request)
    {
        return [
            'id' => $this->id, // 会被BaseResource自动转为字符串
            'name' => $this->name,
            'posts' => PostResource::collection($this->posts)
        ];
    }
}

方案2：全局响应中间件 #

编写一个中间件，拦截所有API响应，自动将所有层级的id字段转为字符串：

namespace App\Http\Middleware;

use Closure;

class ConvertIdsToString
{
    public function handle($request, Closure $next)
    {
        $response = $next($request);
        
        // 仅处理JSON响应
        if ($response instanceof \Illuminate\Http\JsonResponse) {
            $data = $this->processIds($response->getData(true));
            $response->setData($data);
        }
        
        return $response;
    }
    
    private function processIds($data)
    {
        if (is_array($data)) {
            foreach ($data as $key => $value) {
                if ($key === 'id' && is_int($value)) {
                    $data[$key] = (string) $value;
                } else {
                    $data[$key] = $this->processIds($value);
                }
            }
        } elseif (is_object($data)) {
            foreach ($data as $key => $value) {
                if ($key === 'id' && is_int($value)) {
                    $data->$key = (string) $value;
                } else {
                    $data->$key = $this->processIds($value);
                }
            }
        }
        
        return $data;
    }
}

然后在app/Http/Kernel.php中将该中间件加入api中间件组：

protected $middlewareGroups = [
    'api' => [
        // 其他中间件...
        \App\Http\Middleware\ConvertIdsToString::class,
    ],
];

该方案无需修改任何模型或资源，自动处理所有响应的ID，非常省心。

方案3：重写模型toArray方法（不推荐） #

如果不想用资源或中间件，也可以在模型中重写toArray方法转换ID，但需要每个模型都重复编写代码，冗余度高：

public function toArray($request)
{
    $data = parent::toArray($request);
    $data['id'] = (string) $this->id;
    
    // 若有需要，手动处理关联数据的ID
    // if (isset($data['posts'])) {
    //     $data['posts'] = collect($data['posts'])->map(function ($post) {
    //         $post['id'] = (string) $post['id'];
    //         return $post;
    //     })->toArray();
    // }
    
    return $data;
}

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