基于Laravel搭建多店铺统一API，REST无状态购物车存储咨询

Hey 你好！咱们来一步步解决你在Laravel多店铺统一API里的无状态购物车问题——这在多店电商平台里是非常常见的场景，我会从存储方案、RESTful设计、数据库结构到具体代码实现给你理清楚。

无状态的本质是服务器不会在请求之间保存会话数据，所以每一次请求都必须携带足够的信息让服务器识别购物车归属。这里分两种情况：匿名用户和登录用户，得分别处理。

匿名用户（未登录） #

• 客户端临时存储：把购物车数据序列成JSON存在localStorage或sessionStorage里，每次调用API时把数据传过去。优点是简单，不用服务器存数据；缺点是用户清缓存就丢了，而且存储大小有限制（一般5MB左右）。适合简单场景，但不推荐作为主要方案。
• 服务器端关联UUID存储：给每个匿名用户生成一个唯一的cart_uuid，存在客户端的HttpOnly Cookie里（防止XSS），服务器把购物车数据存在数据库，关联这个UUID。这样就算用户清了浏览器缓存，只要Cookie没过期就能找回购物车。Laravel里用Str::uuid()就能生成这个唯一ID。

登录用户 #

• 关联用户ID存储：用户登录后，直接把购物车数据和用户ID绑定。如果用户之前有匿名购物车，要做购物车合并——把匿名购物车的商品合并到用户的专属购物车里，然后删除匿名购物车数据。

按照RESTful规范，针对购物车的接口可以这么设计（要带上店铺ID区分不同店铺）：

• GET /api/stores/{store_id}/cart - 获取当前用户/匿名用户的购物车详情
• POST /api/stores/{store_id}/cart/items - 往购物车添加商品
• PUT /api/stores/{store_id}/cart/items/{item_id} - 修改购物车商品数量
• DELETE /api/stores/{store_id}/cart/items/{item_id} - 删除购物车商品
• POST /api/stores/{store_id}/cart/merge - 登录时合并匿名购物车到用户购物车

针对多店铺+无状态购物车，设计两张表就够了：

carts表（购物车主表） #

// 迁移文件代码
Schema::create('carts', function (Blueprint $table) {
    $table->id();
    $table->foreignId('store_id')->constrained()->onDelete('cascade'); // 关联店铺ID，区分不同店铺的购物车
    $table->foreignId('user_id')->nullable()->constrained()->onDelete('cascade'); // 登录用户ID，匿名时为null
    $table->string('cart_uuid')->unique(); // 匿名用户的唯一标识，登录用户也可以留着备用
    $table->timestamps();
});

cart_items表（购物车商品明细表） #

Schema::create('cart_items', function (Blueprint $table) {
    $table->id();
    $table->foreignId('cart_id')->constrained()->onDelete('cascade'); // 关联购物车主表
    $table->foreignId('product_id')->constrained()->onDelete('cascade'); // 关联商品表
    $table->integer('quantity')->default(1); // 商品数量
    $table->decimal('price', 10, 2); // 记录添加时的商品价格，避免商品调价后购物车价格变动
    $table->timestamps();
});

匿名购物车的初始化 #

当用户第一次访问店铺，没有cart_uuid Cookie时，自动生成并返回：

public function getCart(Request $request, $storeId)
{
    $cartUuid = $request->cookie('cart_uuid');
    // 如果没有cart_uuid，生成一个并设置Cookie（有效期30天）
    if (!$cartUuid) {
        $cartUuid = Str::uuid()->toString();
        // 获取购物车商品（此时为空），同时设置HttpOnly Cookie
        return response()->json([])
            ->cookie(
                'cart_uuid',
                $cartUuid,
                60*24*30, // 有效期30天
                null,
                null,
                env('APP_ENV') === 'production', // 生产环境开启Secure
                true // HttpOnly，防止XSS
            );
    }
    // 根据cart_uuid和店铺ID获取购物车商品
    $cartItems = CartItem::whereHas('cart', function ($query) use ($cartUuid, $storeId) {
        $query->where('cart_uuid', $cartUuid)->where('store_id', $storeId);
    })->with('product')->get();
    return response()->json($cartItems);
}

登录时的购物车合并 #

用户登录后，把匿名购物车的商品合并到用户购物车：

public function mergeCart(Request $request, $storeId)
{
    $user = $request->user();
    $cartUuid = $request->cookie('cart_uuid');
    if (!$cartUuid) {
        return response()->json(['message' => '没有可合并的匿名购物车'], 200);
    }
    // 获取匿名购物车的商品
    $anonymousCart = Cart::where('cart_uuid', $cartUuid)->where('store_id', $storeId)->first();
    if (!$anonymousCart || !$anonymousCart->items->count()) {
        return response()->json(['message' => '匿名购物车为空'], 200);
    }
    // 获取或创建用户的店铺专属购物车
    $userCart = Cart::firstOrCreate(
        ['store_id' => $storeId, 'user_id' => $user->id],
        ['cart_uuid' => Str::uuid()->toString()]
    );
    // 合并商品：如果已存在则累加数量，否则新增
    foreach ($anonymousCart->items as $item) {
        $existingItem = $userCart->items()->where('product_id', $item->product_id)->first();
        if ($existingItem) {
            $existingItem->quantity += $item->quantity;
            $existingItem->save();
        } else {
            $userCart->items()->create([
                'product_id' => $item->product_id,
                'quantity' => $item->quantity,
                'price' => $item->price
            ]);
        }
    }
    // 删除匿名购物车及其商品
    $anonymousCart->items()->delete();
    $anonymousCart->delete();
    // 清除匿名购物车的Cookie
    return response()->json($userCart->items()->with('product')->get())
        ->cookie('cart_uuid', null, -1);
}

• 数据一致性：一定要记录商品添加时的价格，不然商品调价后，用户购物车的价格会跟着变，容易引发纠纷。
• 权限控制：每个接口都要验证用户是否有权访问该店铺的资源，比如店铺管理员只能操作自己店铺的购物车，避免越权。
• 性能优化：可以用Redis缓存购物车数据，比如把用户购物车的序列化数据存在Redis里，减少数据库查询次数，提升API响应速度。
• 跨域处理：如果店铺前端是独立项目，要在Laravel里配置CORS，允许Cookie跨域传递（如果用Cookie存cart_uuid的话）。

内容的提问来源于stack exchange，提问作者Luuk Van Dongen