实战内容

1. 新功能开发

用户端历史订单模块：

• 查询历史订单
• 查询订单详情
• 取消订单
• 再来一单

商家端订单管理模块：

• 订单搜索
• 各个状态的订单数量统计
• 查询订单详情
• 接单
• 拒单
• 取消订单
• 派送订单
• 完成订单

2. 已有功能优化

优化用户下单功能，加入校验逻辑，如果用户的收货地址距离商家门店超出配送范围（配送范围为5公里内），则下单失败。

2 用户端

2.1 历史订单查询

• OrdersController

    /**
     * 历史订单查询
     *
     * @param page
     * @param pageSize
     * @param status
     * @return
     */
    @GetMapping("/historyOrders")
    @ApiOperation("查询历史订单")
    public Result<PageResult> page(Integer page, Integer pageSize, Integer status) {
        PageResult pageResult = ordersService.pageQuery(page, pageSize, status);
        return Result.success(pageResult);
    }

• OrdersService

    /**
     * 用户历史订单分页查询订单
     * @param page
     * @param pageSize
     * @param status
     * @return
     */
    PageResult pageQuery(Integer page, Integer pageSize, Integer status);

• OrdersServiceImpl

    /**
     * 用户端订单分页查询
     * @param page
     * @param pageSize
     * @param status
     * @return
     */
    @Override
    public PageResult pageQuery(Integer page, Integer pageSize, Integer status) {
        //设置分页参数
        PageHelper.startPage(page, pageSize);
        //获取当前用户id
        Long userId = BaseContext.getCurrentId();
        //构造查询条件
        OrdersPageQueryDTO ordersPageQueryDTO = new OrdersPageQueryDTO();
        ordersPageQueryDTO.setUserId(userId);
        ordersPageQueryDTO.setStatus(status);
        //查询数据
        Page<Orders> pageResult = ordersMapper.pageQuery(ordersPageQueryDTO);
        //封装成OrderVO
        List<OrderVO> orderVOList  = new ArrayList<>();
        if (pageResult != null && pageResult.size() > 0){
            // 遍历每个订单，获取订单明细并封装成OrderVO
            for (Orders orders : pageResult) {
                Long orderId = orders.getId();
                // 根据订单id 查询该订单的详细信息
                List<OrderDetail> orderDetailList = orderDetailMapper.getByOrderId(orderId);
                // 创建OrderVO对象并将订单信息拷贝到OrderVO中
                OrderVO orderVO = new OrderVO();
                BeanUtils.copyProperties(orders, orderVO);
                // 设置订单的详细信息列表 到OrderVO对象中
                orderVO.setOrderDetailList(orderDetailList);
                // 将OrderVO添加到结果列表中
                orderVOList.add(orderVO);
            }
        }
        long total = pageResult.getTotal();
        return new PageResult(total, orderVOList);
    }

• OrdersMapper

    /**
     * 分页查询历史订单
     * @param ordersPageQueryDTO
     * @return
     */
    Page<Orders> pageQuery(OrdersPageQueryDTO ordersPageQueryDTO);

• OrdersMapper.xml

    <!--用户端历史订单查询-->
    <select id="pageQuery" resultType="com.sky.entity.Orders">
        select * from orders
        <where>
            <if test="number!=null">
                and number like concat('%',#{number},'%')
            </if>
            <if test="phone!=null">
                and phone like concat('%',#{phone},'%')
            </if>
            <if test="status!=null">
                and status =#{status}
            </if>
            <if test="userId!=null">
                and user_id=#{userId}
            </if>
            <if test="beginTime!=null">
                and order_time &lt;= #{beginTime}
            </if>
            <if test="endTime!=null">
                and order_time &lt;= #{endTime}
            </if>
        </where>
        order by order_time desc
    </select>

• OrderDetailMapper

    /**
     * 根据订单id查询订单明细
     * @param orderId
     * @return
     */
    @Select("select * from order_detail where order_id = #{orderId}")
    List<OrderDetail> getByOrderId(Long orderId);

• 联调测试
  

2.1 查询订单详情

• OrdersController

    /**
     * 查询订单详情
     * @param id
     * @return
     */
    @GetMapping("orderDetail/{id}")
    @ApiOperation("查询订单详情")
    public Result<OrderVO> details(@PathVariable Long id) {
        OrderVO orderVO = ordersService.findDetailsById(id);
        return Result.success(orderVO);
    }

• OrdersService

    /**
     * 查询订单详情
     * @param id
     * @return
     */
    OrderVO findDetailsById(Long id);

• OrdersServiceImpl

    /**
     * 查询订单详情
     *
     * @param id
     * @return
     */
    @Override
    public OrderVO findDetailsById(Long id) {
        //根据订单id查询订单的基本信息
        Orders orders = ordersMapper.getById(id);
        //查询该订单对应的菜品/套餐明细
        List<OrderDetail> orderDetailList = orderDetailMapper.getByOrderId(orders.getId());
        //封装成OrderVO
        OrderVO orderVO = new OrderVO();
        // 将订单的基本信息复制到OrderVO对象中
        BeanUtils.copyProperties(orders, orderVO);
        // 将该订单的菜品/套餐明细添加到OrderVO中
        orderVO.setOrderDetailList(orderDetailList);
        return orderVO;
    }

• OrdersMapper

    /**
     * 根据id查询订单
     * @param id
     * @return
     */
    @Select("select * from orders where id = #{id}")
    Orders getById(Long id);

• 联调测试
  

2.2 取消订单(跳过微信支付)

• OrdersController

    /**
     * 取消订单
     * @param id
     * @return
     */
    @PutMapping("/cancel/{id}")
    @ApiOperation("取消订单")
    public Result cancel(@PathVariable Long id) throws Exception {
        ordersService.cancelOrderById(id);
        return Result.success();
    }

• OrdersService

    /**
     * 用户取消订单
     * @param id
     */
    void cancelOrderById(Long id) throws Exception ;

• OrdersServiceImpl

    /**
     * 用户取消订单
     *
     * 业务规则：
     * - 待支付和待接单状态下，用户可直接取消订单
     * - 商家已接单状态下，用户取消订单需电话沟通商家
     * - 派送中状态下，用户取消订单需电话沟通商家
     * - 如果在待接单状态下取消订单，需要给用户退款
     * - 取消订单后需要将订单状态修改为“已取消”
     *
     * @param id 订单ID
     * @throws Exception 异常处理，可能由于订单状态不符合取消条件或其他系统异常
     */
    @Override
    public void cancelOrderById(Long id) throws Exception {
        // 根据订单ID查询订单信息
        Orders orderMapperById = ordersMapper.getById(id);
        // 判断订单是否存在，如果订单不存在，则抛出异常
        if (orderMapperById == null) {
            throw new OrderBusinessException(MessageConstant.ORDER_NOT_FOUND);
        }
        // 订单状态 1待付款 2待接单 3已接单 4派送中 5已完成 6已取消
        // 如果订单状态大于2（即已接单或派送中等），则不能取消订单
        if (orderMapperById.getStatus() > 2) {
            throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);
        }
        // 创建新的订单对象，用于更新订单状态
        Orders orders = new Orders();
        orders.setId(orderMapperById.getId());
        // 订单处于待接单状态下取消，调用微信支付接口进行退款
        if (orderMapperById.getStatus().equals(Orders.TO_BE_CONFIRMED)) {
            // 调用微信支付退款接口进行退款
//            weChatPayUtil.refund(
//                    orderMapperById.getNumber(), // 商户订单号
//                    orderMapperById.getNumber(), // 商户退款单号
//                    new BigDecimal(0.01), // 退款金额，单位为元
//                    new BigDecimal(0.01)  // 原订单金额
//            );
            // 修改支付状态为退款状态
            orders.setPayStatus(Orders.REFUND);
        }
        // 更新订单状态为“已取消”，并设置取消原因和取消时间
        orders.setStatus(Orders.CANCELLED);
        orders.setRejectionReason("用户取消");
        orders.setCancelTime(LocalDateTime.now());
        // 更新数据库中的订单信息
        ordersMapper.update(orders);
    }

• 联调测试
  

2.2 在来一单

• OrdersController

    /**
     * 再来一单
     * @param id
     * @return
     */
    @PostMapping("/repetition/{id}")
    @ApiOperation("再来一单")
    public Result repetition(@PathVariable Long id) {
        ordersService.repetition(id);
        return Result.success();
    }

• OrdersService

    /**
     * 再来一单
     * @param id
     */
    void repetition(Long id);

• OrdersServiceImpl

    /**
     * 再来一单功能实现：将历史订单中的商品重新加入购物车
     * @param id 订单ID（注意：这里是订单表的主键id，不是用户id）
     */
    @Override
    public void repetition(Long id) {
        // 从线程局部变量获取当前登录用户ID（通过JWT拦截器设置）
        Long userId = BaseContext.getCurrentId();
        // 【关键修复点】使用订单ID查询订单详情（原错误：此处误传用户ID）
        // 查询order_detail表中与指定订单ID关联的所有商品明细
        List<OrderDetail> orderDetailList = orderDetailMapper.getByOrderId(id);
        // 将订单明细转换为购物车对象（核心数据迁移逻辑）
        List<ShoppingCart> shoppingCartList = orderDetailList.stream().map(x -> {
            ShoppingCart shoppingCart = new ShoppingCart();
            // 【关键操作】复制属性：将订单明细字段映射到购物车对象
            // 排除id字段：保证购物车记录生成新的自增ID
            BeanUtils.copyProperties(x, shoppingCart, "id");
            // 【关键修复点】显式设置用户ID（原错误：该字段未赋值导致数据库存null）
            shoppingCart.setUserId(userId);
            // 设置当前时间为购物车记录的创建时间
            shoppingCart.setCreateTime(LocalDateTime.now());
            return shoppingCart;
        }).collect(Collectors.toList());
        // 批量插入购物车表（核心存储逻辑）
        // 注意：需要确保shopping_cart表的user_id字段不能为NULL
        shoppingCartMapper.insertBatch(shoppingCartList);
    }

• ShoppingCartMapper

    /**
     * 批量插入购物车数据
     * @param shoppingCartList
     */
    void insertBatch(List<ShoppingCart> shoppingCartList);

• ShoppingCartMapper.xml

    <!--批量插入购物车数据-->
    <insert id="insertBatch" parameterType="list">
        insert into shopping_cart
        (name, image, user_id, dish_id, setmeal_id, dish_flavor, number, amount, create_time)
        values
        <foreach collection="shoppingCartList" item="sc" separator=",">
            (#{sc.name},#{sc.image},#{sc.userId},#{sc.dishId},#{sc.setmealId},#{sc.dishFlavor},#{sc.number},#{sc.amount},#{sc.createTime})
        </foreach>
    </insert>

• 联调测试
  

3 商家端

3.1 订单搜索

• OrdersController

package com.sky.controller.admin;

import com.sky.dto.OrdersPageQueryDTO;
import com.sky.result.PageResult;
import com.sky.result.Result;
import com.sky.service.OrdersService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController("adminOrdersController")
@RequestMapping("/admin/order")
@Slf4j
@Api(tags = "订单管理接口")
public class OrdersController {
    @Autowired
    private OrdersService ordersService;
    /**
     * 订单搜索
     *
     * @param ordersPageQueryDTO
     * @return
     */
    @GetMapping("/conditionSearch")
    @ApiOperation("订单搜索")
    public Result<PageResult> conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO) {
        PageResult pageResult = ordersService.conditionSearch(ordersPageQueryDTO);
        return Result.success(pageResult);
    }
}

• OrdersService

    /**
     * 订单搜索
     * @param ordersPageQueryDTO
     * @return
     */
    PageResult conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO);

• OrdersServiceImpl

    /**
     * 订单搜索
     *
     * @param ordersPageQueryDTO
     * @return
     */
    @Override
    public PageResult conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO) {
        PageHelper.startPage(ordersPageQueryDTO.getPage(), ordersPageQueryDTO.getPageSize());
        Page<Orders> page = ordersMapper.pageQuery(ordersPageQueryDTO);
        // 部分订单状态，需要额外返回订单菜品信息，将Orders转化为OrderVO
        List<OrderVO> orderVOList = getOrderVOList(page);
        return new PageResult(page.getTotal(), orderVOList);
    }

    private List<OrderVO> getOrderVOList(Page<Orders> page) {
        // 需要返回订单菜品信息，自定义OrderVO响应结果
        List<OrderVO> orderVOList = new ArrayList<>();
        List<Orders> ordersList = page.getResult();
        if (!CollectionUtils.isEmpty(ordersList)) {
            for (Orders orders : ordersList) {
                // 将共同字段复制到OrderVO
                OrderVO orderVO = new OrderVO();
                BeanUtils.copyProperties(orders, orderVO);
                String orderDishes = getOrderDishesStr(orders);
                // 将订单菜品信息封装到orderVO中，并添加到orderVOList
                orderVO.setOrderDishes(orderDishes);
                orderVOList.add(orderVO);
            }
        }
        return orderVOList;
    }
    /**
     * 根据订单id获取菜品信息字符串
     *
     * @param orders
     * @return
     */
    private String getOrderDishesStr(Orders orders) {
        // 查询订单菜品详情信息（订单中的菜品和数量）
        List<OrderDetail> orderDetailList = orderDetailMapper.getByOrderId(orders.getId());
        // 将每一条订单菜品信息拼接为字符串（格式：宫保鸡丁*3；）
        List<String> orderDishList = orderDetailList.stream().map(x -> {
            String orderDish = x.getName() + "*" + x.getNumber() + ";";
            return orderDish;
        }).collect(Collectors.toList());
        // 将该订单对应的所有菜品信息拼接在一起
        return String.join("", orderDishList);
    }

• 联调测试
  

3.2 各个状态的订单数量统计

• OrdersController

    /**
     * 各个状态的订单数量统计
     * @return
     */
    @GetMapping("/statistics")
    @ApiOperation("各个状态的订单数量统计")
    public Result<OrderStatisticsVO> getOrderStatistics() {
        return Result.success(ordersService.getOrderStatistics());
    }

• OrdersService

    /**
     * 各个状态的订单数量统计
     * @return
     */
    OrderStatisticsVO getOrderStatistics();

• OrdersServiceImpl

    /**
     * 各个状态的订单数量统计
     * @return
     */
    @Override
    public OrderStatisticsVO getOrderStatistics() {
        // 根据状态，分别查询出待接单、待派送、派送中的订单数量
        Integer toBeConfirmed = ordersMapper.countStatus(Orders.TO_BE_CONFIRMED);
        Integer confirmed = ordersMapper.countStatus(Orders.CONFIRMED);
        Integer deliveryInProgress = ordersMapper.countStatus(Orders.DELIVERY_IN_PROGRESS);
        // 将查询出的数据封装到orderStatisticsVO中响应
        OrderStatisticsVO orderStatisticsVO = new OrderStatisticsVO();
        orderStatisticsVO.setToBeConfirmed(toBeConfirmed);
        orderStatisticsVO.setConfirmed(confirmed);
        orderStatisticsVO.setDeliveryInProgress(deliveryInProgress);
        return orderStatisticsVO;
    }

• OrdersMapper

    /**
     * 各个状态的订单数量统计
     * @param toBeConfirmed
     * @return
     */
    @Select("select count(id) from orders where status = #{status}")
    Integer countStatus(Integer toBeConfirmed);

• 联调测试
  

3.3 查询订单详情

• OrdersController

    /**
     * 查询订单详情
     * 业务规则：
     * - 订单详情页面需要展示订单基本信息（状态、订单号、下单时间、收货人、电话、收货地址、金额等）
     * - 订单详情页面需要展示订单明细数据（商品名称、数量、单价）
     * @param id
     * @return
     */
    @GetMapping("/details/{id}")
    @ApiOperation("查询订单详情")
    public Result<OrderVO> details(@PathVariable Long id) {
        OrderVO orderVO = ordersService.findDetailsById(id);
        return Result.success(orderVO);
    }

• 联调测试
  

3.4 接单

• OrdersController

    /**
     * 接单
     * @param ordersConfirmDTO
     * @return
     */
    @PutMapping("/confirm")
    @ApiOperation("接单")
    public Result confirm(@RequestBody OrdersConfirmDTO ordersConfirmDTO) {
        ordersService.confirm(ordersConfirmDTO);
        return Result.success();
    }

• OrdersService

    /**
     * 接单
     * @param ordersConfirmDTO
     */
    void confirm(OrdersConfirmDTO ordersConfirmDTO);

• OrdersServiceImpl

    /**
     * 将订单的状态修改为 “已接单”
     * @param ordersConfirmDTO
     */
    @Override
    public void confirm(OrdersConfirmDTO ordersConfirmDTO) {
        Orders orders = Orders.builder()
                .id(ordersConfirmDTO.getId())
                .status(Orders.CONFIRMED)
                .build();
        ordersMapper.update(orders);
    }

• 联调测试
  

3.5 拒单

• OrdersController

    /**
     * 拒单
     * @param ordersRejectionDTO
     * @return
     * @throws Exception
     */
    @PutMapping("/rejection")
    @ApiOperation("拒单")
    public Result rejection(@RequestBody OrdersRejectionDTO ordersRejectionDTO) throws Exception {
        ordersService.rejection(ordersRejectionDTO);
        return Result.success();
    }

• OrdersService

    /**
     * 拒单
     * @param ordersRejectionDTO
     */
    void rejection(OrdersRejectionDTO ordersRejectionDTO) throws Exception ;

• OrdersServiceImpl

    /**
     * 拒单
     * @param ordersRejectionDTO
     */
    @Override
    public void rejection(OrdersRejectionDTO ordersRejectionDTO) throws Exception  {
        // 根据id查询订单
        Orders ordersDB = ordersMapper.getById(ordersRejectionDTO.getId());
        // 订单只有存在且状态为2（待接单）才可以拒单
        if (ordersDB == null || !ordersDB.getStatus().equals(Orders.TO_BE_CONFIRMED)) {
            throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);
        }
        // 需要判断订单支付状态，订单处于待接单状态下取消，需要进行退款
        if (ordersDB.getPayStatus().equals(Orders.PAID)) {
            //用户已支付，需要退款
            // String refund = weChatPayUtil.refund(
            //         ordersDB.getNumber(),
            //         ordersDB.getNumber(),
            //         new BigDecimal("0.01"),
            //         new BigDecimal("0.01"));
            // log.info("申请退款：{}", refund);
            log.info("申请退款,修改支付状态");
            ordersDB.setPayStatus(Orders.REFUND);
        }
        // 拒单需要退款，根据订单id更新订单状态、拒单原因、取消时间
        ordersDB.setStatus(Orders.CANCELLED);
        ordersDB.setRejectionReason(ordersRejectionDTO.getRejectionReason());
        ordersDB.setCancelTime(LocalDateTime.now());
        ordersMapper.update(ordersDB);
    }

• 联调测试
  
  

3.6 取消订单

• OrdersController

    /**
     * 取消订单
     *
     * @return
     */
    @PutMapping("/cancel")
    @ApiOperation("取消订单")
    public Result cancel(@RequestBody OrdersCancelDTO ordersCancelDTO) throws Exception {
        ordersService.cancel(ordersCancelDTO);
        return Result.success();
    }

• OrdersService

    /**
     * 取消订单
     * @param ordersCancelDTO
     */
    void cancel(OrdersCancelDTO ordersCancelDTO) throws Exception;

• OrdersServiceImpl

    /**
     * 取消订单
     *
     * 业务规则：
     * - 取消订单其实就是将订单状态修改为“已取消”
     * - 商家取消订单时需要指定取消原因
     * - 商家取消订单时，如果用户已经完成了支付，需要为用户退款
     * @param ordersCancelDTO
     */
    public void cancel(OrdersCancelDTO ordersCancelDTO) throws Exception {
        Orders orders = ordersMapper.getById(ordersCancelDTO.getId());
        //获取订单状态
        Integer payStatus = orders.getPayStatus();
        //如果用户已经完成了支付，需要为用户退款
        if (payStatus==Orders.PAID){
        /* String refund = weChatPayUtil.refund(
                    orders.getNumber(),
                    orders.getNumber(),
                    new BigDecimal(0.01),
                    new BigDecimal(0.01));
            log.info("申请退款：{}", refund);*/
            log.info("取消订单,退款");
        }
        // 管理端取消订单需要退款，根据订单id更新订单状态、取消原因、取消时间
        Orders build = Orders.builder()
                .id(ordersCancelDTO.getId())
                .status(Orders.CANCELLED)
                .payStatus(Orders.REFUND)
                .cancelReason(ordersCancelDTO.getCancelReason())
                .cancelTime(LocalDateTime.now())
                .build();
        ordersMapper.update(build);
    }

• 联调测试
  

3.7 派送订单

• OrdersController

    /**
     * 派送订单
     *
     * @return
     */
    @PutMapping("/delivery/{id}")
    @ApiOperation("派送订单")
    public Result delivery(@PathVariable("id") Long id) {
        ordersService.delivery(id);
        return Result.success();
    }

• OrdersService

    /**
     * 派送订单
     * @param id
     */
    void delivery(Long id);

• OrdersServiceImpl

    /**
     * 派送订单
     *
     * 业务规则：
     * - 派送订单其实就是将订单状态修改为“派送中”
     * - 只有状态为“待派送”的订单可以执行派送订单操作
     * @param id
     */
    public void delivery(Long id) {
        //根据id获取订单信息
        Orders orders = ordersMapper.getById(id);
        // 只有状态为“待派送”的订单可以执行派送订单操作
        if (orders.getStatus()==null && !orders.getStatus().equals(Orders.CONFIRMED)){
            throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);
        }
        // 更新订单状态,状态转为派送中
        Orders build = Orders.builder()
                .id(orders.getId())
                .status(Orders.DELIVERY_IN_PROGRESS)
                .build();
        ordersMapper.update(build);
    }

• 联调测试
  
  

3.8 完成订单

• OrdersController

    /**
     * 完成订单
     *
     * @return
     */
    @PutMapping("/complete/{id}")
    @ApiOperation("完成订单")
    public Result complete(@PathVariable("id") Long id) {
        ordersService.complete(id);
        return Result.success();
    }

• OrdersService

    /**
     * 完成订单
     * @param id
     */
    void complete(Long id);

• OrdersServiceImpl

    /**
     * 完成订单
     * @param id
     */
    public void complete(Long id) {
        Orders orders = ordersMapper.getById(id);
        if (orders.getStatus()==null && !orders.getStatus().equals(Orders.DELIVERY_IN_PROGRESS)){
            throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);
        }
        Orders build = Orders.builder()
                .id(orders.getId())
                .status(Orders.COMPLETED)
                .deliveryTime(LocalDateTime.now())
                .build();
        ordersMapper.update(build);
    }

• 联调测试
  

4 基于百度地图在下单时加入逻辑判断

4.1 环境准备

1. 基于百度地图开放平台实现https://lbsyun.baidu.com/

2. 注册账号—>创建应用获取AK(服务端应用)—>调用接口

   点击控制台–>应用管理–>我的应用–>创建应用如下所示：

3. 相关文档

   地理编码
   路线规划服务

4. 商家门店地址可以配置在配置文件中，例如：

     shop:
       # 商铺地址
       address: XXXXXXXXXXXXXXXXXXXXXXXXXXXX
       # 百度地址AK
       ak: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
       #配送距离极限--单位：米
       distance: 5000
   

4.2 代码开发

• application.yml中新增

  shop:
    #商铺地址
    address: ${sky.shop.address}
    #百度地图AK
    ak: ${sky.shop.ak}
    #配送距离极限--单位：米
    distance: ${sky.shop.distance}

• application-dev.yml中新增

  shop:
    # 商铺地址
    address: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
    # 百度地址AK
    ak: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
    #配送距离极限--单位：米
    distance: 5000

• 在OrdersServiceImpl中新增代码

	。。。
	。。。
	@Value("${sky.shop.address}")
    private String shopAddress;     //店铺地址
    @Value("${sky.shop.ak}")
    private String ak;              //百度地图应用服务ak
    @Value("${sky.shop.distance}")
    private Integer distance;       //配送距离上限
    //地理编码接口，获取地址的经纬度坐标
    private static final String GEO_CODING_URL = "https://api.map.baidu.com/geocoding/v3/";
    //路线规划接口，骑行路线规划，（可以视业务情况选择骑行、公交、驾车等路线，接口不一样，可以配置在yml中）
    private static final String DIRECTION_URL = "https://api.map.baidu.com/directionlite/v1/riding";
    。。。
    。。。
    在submitOrders用户下单方法中添加校验配送范围
    。。。
    if (cartList == null || cartList.size() == 0) {
         throw new OrderBusinessException(MessageConstant.SHOPPING_CART_IS_NULL);
    }
     //优化下单逻辑：需要检验配送范围（如果超过5公里，就抛出自定义异常）
     if (!checkOutOfRange(addressBook.getProvinceName()+addressBook.getCityName()+addressBook.getDistrictName()+addressBook.getDetail())) {
         throw new OrderBusinessException(MessageConstant.OUT_OF_RANGE);
      }
     //1.构造订单数据，存入到orders表中
     Orders orders = new Orders();
     //拷贝属性值
     BeanUtils.copyProperties(ordersSubmitDTO, orders);
     。。。
     。。。
    /**
     * 检查客户的收货地址是否超出配送范围
     * @param address
     */
    private void checkOutOfRange(String address) {
        Map map = new HashMap();
        map.put("address",shopAddress);
        map.put("output","json");
        map.put("ak",ak);

        //获取店铺的经纬度坐标
        String shopCoordinate = HttpClientUtil.doGet("https://api.map.baidu.com/geocoding/v3", map);

        JSONObject jsonObject = JSON.parseObject(shopCoordinate);
        if(!jsonObject.getString("status").equals("0")){
            throw new OrderBusinessException(MessageConstant.ADDRESS_PARSE_FAILED);
        }

        //数据解析
        JSONObject location = jsonObject.getJSONObject("result").getJSONObject("location");
        String lat = location.getString("lat");
        String lng = location.getString("lng");
        //店铺经纬度坐标
        String shopLngLat = lat + "," + lng;

        map.put("address",address);
        //获取用户收货地址的经纬度坐标
        String userCoordinate = HttpClientUtil.doGet("https://api.map.baidu.com/geocoding/v3", map);

        jsonObject = JSON.parseObject(userCoordinate);
        if(!jsonObject.getString("status").equals("0")){
            throw new OrderBusinessException(MessageConstant.RECEIVING_ADDRESS_PARSING_FAILED);
        }

        //数据解析
        location = jsonObject.getJSONObject("result").getJSONObject("location");
        lat = location.getString("lat");
        lng = location.getString("lng");
        //用户收货地址经纬度坐标
        String userLngLat = lat + "," + lng;

        map.put("origin",shopLngLat);
        map.put("destination",userLngLat);
        map.put("steps_info","0");

        //路线规划
        String json = HttpClientUtil.doGet("https://api.map.baidu.com/directionlite/v1/driving", map);

        jsonObject = JSON.parseObject(json);
        if(!jsonObject.getString("status").equals("0")){
            throw new OrderBusinessException(MessageConstant.DELIVERY_ROUTE_PLANNING_FAILED);
        }

        //数据解析
        JSONObject result = jsonObject.getJSONObject("result");
        JSONArray jsonArray = (JSONArray) result.get("routes");
        Integer distance = (Integer) ((JSONObject) jsonArray.get(0)).get("distance");

        if(distance > this.distance){
            throw new OrderBusinessException(MessageConstant.OUT_OF_RANGE);
        }
    }

4.3 bug调试

4.3.1 修改小程序端代码

我们在测试的时候发现小程序端和后端控制台会输出超出配送范围，但是小程序端不会提示。

如下图，我们找到common包下的vendor.js，然后按Ctrl + F然后搜索submitOrderSubmit

下拉在拨打电话注释前面，图中框起来的分号前面加上一个回调函数

.catch(function (error) {
        // 处理错误响应
        console.error('请求失败:', error);
        uni.showToast({
          title: error.msg || '请求失败',
          icon: 'none'
        });
      })

重新编译微信小程序代码，然后在提交订单页面点击”去支付“，就会跳出“超出配送范围的提示信息”