Medusa JS后端无定制源码，如何配置实现后端加购功能？

Medusa本身内置了完整的购物车核心机制，包括数据库存储、Cart实体及相关服务。以下是配置后端实现加购功能的具体步骤，既可以直接用官方API快速落地，也可以自定义路由扩展业务逻辑：

一、利用Medusa官方购物车API（最快方案） #

Medusa默认提供了开箱即用的购物车操作REST API，无需从零开发：

• 创建购物车：POST /store/carts
• 添加商品到购物车：POST /store/carts/:id/line-items
• 获取购物车详情：GET /store/carts/:id

直接在前端调用这些官方接口，替换原本基于浏览器存储的逻辑，数据会自动存入Medusa的数据库。

二、自定义路由与控制器（如需扩展逻辑） #

如果需要自定义业务规则（比如库存校验、自定义字段处理），可以在medusa项目中创建自定义路由：

1. 在medusa/src/api目录下新建路由文件（无api目录则手动创建），比如src/api/cart/add-item/route.ts，写入以下代码：

import { MedusaRequest, MedusaResponse } from "@medusajs/medusa";
import { CartService } from "@medusajs/medusa/dist/services";

export async function POST(req: MedusaRequest, res: MedusaResponse) {
  // 从Medusa依赖容器中获取Cart服务实例
  const cartService: CartService = req.scope.resolve("cartService");
  
  // 解析请求体参数：购物车ID（可选）、商品变体ID、数量
  const { cart_id, variant_id, quantity = 1 } = req.body;

  try {
    let cart;
    if (cart_id) {
      // 已有购物车，添加商品
      cart = await cartService.addLineItem(cart_id, {
        variant_id,
        quantity,
      });
    } else {
      // 新建购物车并添加商品
      cart = await cartService.create({
        line_items: [
          {
            variant_id,
            quantity,
          },
        ],
      });
    }

    res.status(200).json({
      success: true,
      cart,
    });
  } catch (error) {
    res.status(400).json({
      success: false,
      message: error.message,
    });
  }
}

2. （可选）扩展Cart实体或服务
   如果需要给购物车添加自定义字段（比如用户备注），在src/models/cart.ts中扩展实体：

import { Cart } from "@medusajs/medusa";
import { Entity, Column } from "typeorm";

@Entity()
export class CustomCart extends Cart {
  @Column({ type: "varchar", nullable: true })
  custom_note?: string;
}

如果需要重写购物车逻辑（比如自定义库存校验），在src/services/cart.ts中创建自定义服务：

import { CartService as MedusaCartService } from "@medusajs/medusa";
import { Lifetime } from "awilix";

export class CartService extends MedusaCartService {
  static LIFE_TIME = Lifetime.SCOPED;

  async addLineItem(cartId: string, data: { variant_id: string; quantity: number }) {
    // 自定义库存校验逻辑
    const variantService = this.container.resolve("productVariantService");
    const variant = await variantService.retrieve(data.variant_id);
    if (variant.inventory_quantity < data.quantity) {
      throw new Error("库存不足，无法添加");
    }

    // 调用父类原生方法完成添加
    return super.addLineItem(cartId, data);
  }
}

三、更新前端调用逻辑 #

将前端原本基于浏览器存储的加购逻辑替换为调用后端API，示例代码（Next.js中）：

const addToCart = async (variantId, quantity = 1) => {
  const cartId = localStorage.getItem("medusa_cart_id");

  const response = await fetch(`${process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL}/api/cart/add-item`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      cart_id: cartId,
      variant_id: variantId,
      quantity,
    }),
  });

  const data = await response.json();
  if (data.success) {
    // 将新购物车ID存入本地存储
    localStorage.setItem("medusa_cart_id", data.cart.id);
    // 更新前端购物车状态
    setCart(data.cart);
  } else {
    alert(data.message);
  }
};

四、启动后端服务 #

在medusa项目根目录执行以下命令，使自定义代码生效：

npm run build
npm run dev

内容的提问来源于stack exchange，提问作者Mohd Kashif Shaikh