1. 业务问题与边界#

购物车不是下单事实源，但订单需要它提供：

1. 当前用户已勾选的商品；
2. 商品数量和快照价格；
3. 核价失败后的价格刷新入口；
4. 订单保存后的购物车清理入口。

本文聚焦购物车与订单服务的契约。订单落库、仓储锁库存和延迟关单由订单专题展开。

2. 服务协作图#

3. 购物车内部 API#

源码：duolaimall-cart/cart-service/src/main/java/com/cskaoyan/mall/cart/controller/inner/CartApiController.java，CartApiController。

1
@GetMapping("/api/cart/inner/getCartCheckedList/{userId}")
2
public List<CartInfoDTO> getCartCheckedList(
3
        @PathVariable String userId) {
4
    return cartService.getCartCheckedList(userId);
5
}
6

7
@GetMapping("/api/cart/inner/refresh/{userId}/{skuId}")
8
public Result refreshCartPrice(
9
        @PathVariable String userId,
10
        @PathVariable Long skuId) {
11
    cartService.refreshCartPrice(userId, skuId);
12
    return Result.ok();
13
}
14

15
@PutMapping("/api/cart/inner/delete/order/cart/{userId}")
16
public Result removeCartProductsInOrder(
17
        @PathVariable String userId,
18
        @RequestBody List<Long> skuIds) {
19
    cartService.delete(userId, skuIds);
20
    return Result.ok();
21
}

三个接口分别对应“读已选、刷新单项价格、按订单商品批删”。

代码中没有额外内部调用认证；是否由部署网络限制访问，本轮未验证。

4. 订单侧 Feign 契约#

源码：duolaimall-order/order-service/src/main/java/com/cskaoyan/mall/order/client/CartApiClient.java，CartApiClient。

1
@FeignClient("service-cart")
2
public interface CartApiClient {
3
    @GetMapping("/api/cart/inner/getCartCheckedList/{userId}")
4
    List<CartInfoDTO> getCartCheckedList(
5
            @PathVariable String userId);
6

7
    @GetMapping("/api/cart/inner/refresh/{userId}/{skuId}")
8
    Result refreshCartPrice(
9
            @PathVariable String userId,
10
            @PathVariable Long skuId);
11

12
    @PutMapping("/api/cart/inner/delete/order/cart/{userId}")
13
    Result removeCartProductsInOrder(
14
            @PathVariable String userId,
15
            @RequestBody List<Long> skuIds);
16
}

服务名、HTTP 方法、路径变量和请求体必须与 Cart Controller 一致。

这里不是共享 Java 接口继承，契约需要两端分别维护。

5. 只返回已选商品#

源码：duolaimall-cart/cart-service/src/main/java/com/cskaoyan/mall/cart/service/impl/CartServiceImpl.java，getCartCheckedList。

1
public List<CartInfoDTO> getCartCheckedList(String userId) {
2
    RMap<Long, CartInfoDTO> map =
3
            redissonClient.getMap(buildKey(userId));
4

5
    return map.entrySet().stream()
6
            .filter(entry ->
7
                    entry.getValue().getIsChecked() == 1)
8
            .map(Map.Entry::getValue)
9
            .collect(Collectors.toList());
10
}

订单服务不必取得整车后再解释勾选状态，由购物车域直接输出已选视图。

如果 isChecked 为 null，与整数 1 比较可能因自动拆箱失败。

6. 交易页怎样计算数量和金额#

源码：duolaimall-order/order-service/src/main/java/com/cskaoyan/mall/order/controller/OrderController.java，OrderController#trade。

1
List<CartInfoDTO> cartItems =
2
        cartApiClient.getCartCheckedList(userId);
3

4
List<OrderDetailDTO> orderDetails =
5
        cartInfoConverter
6
                .convertCartInfoDTOToOrderDetailDTOList(cartItems);
7

8
int totalNum = cartItems.stream()
9
        .mapToInt(CartInfoDTO::getSkuNum)
10
        .sum();
11

12
BigDecimal totalAmount = cartItems.stream()
13
        .map(item -> item.getSkuPrice().multiply(
14
                new BigDecimal(item.getSkuNum())))
15
        .reduce(BigDecimal.ZERO, BigDecimal::add);

金额明确使用 skuPrice，不是 cartPrice。

转换器同样把 skuPrice 写入订单明细价格：

1
@Mapping(source = "skuPrice", target = "orderPrice")
2
OrderDetailDTO convertCartInfoDTOToOrderDetailDTO(
3
        CartInfoDTO cartInfoDTO);

7. 为什么提交时仍要核价#

购物车保存的是快照；加入购物车后商品可能调价，客户端也可能篡改提交参数。

订单提交会重新调用商品服务取得当前价格，再与请求中的订单价比较。

源码：OrderController#submitOrder 价格校验片段。

1
BigDecimal orderPrice = orderDetailParam.getOrderPrice();
2
Long skuId = orderDetailParam.getSkuId();
3
BigDecimal currentPrice = productApiClient.getSkuPrice(skuId);
4

5
if (!orderPrice.equals(currentPrice)) {
6
    cartApiClient.refreshCartPrice(userId, skuId);
7
    return Result.fail()
8
            .message(orderDetailParam.getSkuName()
9
                    + " 价格发生变动!");
10
}

核价失败后不保存订单，而是刷新购物车并要求客户端重新提交。

BigDecimal.equals 同时比较数值和 scale，例如 10.0 与 10.00 不相等；这是订单侧候选风险。

8. 价格刷新字段不一致#

源码：CartServiceImpl#refreshCartPrice。

1
public void refreshCartPrice(String userId, Long skuId) {
2
    RMap<Long, CartInfoDTO> map =
3
            redissonClient.getMap(buildKey(userId));
4

5
    CartInfoDTO item = map.get(skuId);
6
    BigDecimal currentPrice = productApiClient.getSkuPrice(skuId);
7

8
    item.setCartPrice(currentPrice);
9
    map.put(skuId, item);
10
}

该方法只更新 cartPrice。

但交易页计算和购物车转订单明细读取 skuPrice，因此刷新后下一次交易和提交可能仍使用旧字段。

这是代码已确认的字段路径不一致；是否在真实页面流程中反复触发核价失败，本轮未运行验证。

SKU 不在购物车时，item 为 null，也存在空指针触发路径。

9. 订单保存后的购物车清理#

源码：OrderController#submitOrder 相关片段。

1
Long orderId = orderService.saveOrderInfo(orderInfo);
2

3
List<Long> skuIds = orderDetailList.stream()
4
        .map(OrderDetailParam::getSkuId)
5
        .collect(Collectors.toList());
6

7
cartApiClient.removeCartProductsInOrder(userId, skuIds);
8

9
baseProducer.sendDelayMessage(
10
        MqTopicConst.DELAY_ORDER_TOPIC,
11
        orderId,
12
        7);

顺序：

1
订单本地保存
2
  -> Feign 删除购物车
3
  -> 发送订单延迟消息

10. 购物车怎样批删#

源码：CartServiceImpl#delete。

1
public void delete(String userId, List<Long> skuIds) {
2
    RMap<Long, CartInfoDTO> map =
3
            redissonClient.getMap(buildKey(userId));
4
    skuIds.forEach(map::remove);
5
}

这不是单个批量 Redis 命令，而是对列表逐项 remove。

若中途失败，可能只删除部分 SKU。

11. 跨服务事务边界#

订单本地保存、购物车 Redis 删除和 RocketMQ 发送不在同一个分布式事务中。

订单服务的本地事务不能回滚购物车服务的 Redis，也不能保证 MQ 一定发送成功。

12. 失败矩阵#

这些是按语句顺序得到的静态判断，不是故障注入结果。

13. 并发边界#

14. HTTP 语义边界#

价格刷新内部接口使用 GET，但会修改 Redis：

1
GET /api/cart/inner/refresh/{userId}/{skuId}

这与常见 GET 无副作用语义不一致，可能影响缓存、监控和调用重放的理解。

删除订单购物车使用 PUT 并携带 SKU ID 请求体，契约两端当前一致。

15. 数据归属与信任#

内部 API 直接接收路径中的 userId，购物车服务按该 ID 拼接 Redis key。

代码本身没有再次校验调用方或用户归属。

在受控服务网络中可能由 Gateway、服务治理或网络策略保护，但本轮未验证部署边界，不能把内部路径等同于已完成鉴权。

16. 当前实现限制#

• 订单交易金额和明细价格读取 skuPrice。
• 价格刷新只更新 cartPrice。
• 价格刷新对不存在 SKU 没有空值保护。
• 已选过滤依赖 isChecked 非空且等于 1。
• 下单后删除是逐项 remove。
• 订单保存、删车和 MQ 不在同一事务。
• 内部刷新使用 GET 修改状态。
• 没有购物车清理补偿或版本标记证据。

17. 候选风险#

候选风险表示存在代码触发机制，不代表已经发生。

18. 如果重做（非当前实现）#

1. 收敛购物车价格字段，刷新订单实际读取的字段；
2. 金额比较使用业务明确的 scale 或 compareTo 规则；
3. 下单建立交易幂等键，避免重试重复落库；
4. 清理购物车使用幂等事件或带版本的批量操作；
5. 对失败清理建立重试和可观测记录；
6. 内部写接口使用符合语义的 HTTP 方法；
7. 为内部 API 增加服务身份或受控网络保护。

19. 关键源码导航#

20. 短复习点#

1. 订单通过内部 Feign 只读取 isChecked=1 的购物车条目。
2. 交易页和订单明细都读取 skuPrice，而刷新只修改 cartPrice。
3. 保存订单、删除购物车和发送延迟消息是三个跨边界步骤。
4. 批删逐项 remove，失败时可能部分完成。
5. 购物车是提交输入之一，不是价格和订单状态的最终事实源。

21. 一句话总结#

多来买通过内部 Feign 把已选购物车交给订单，并在核价失败或落库成功后回调购物车；服务职责清楚，但价格字段、批删原子性、提交幂等和跨服务补偿仍未闭环。