Java AI 辅助开发电商系统核心功能模块实战指南

2.2.2 实体类与 DTO（自动生成）

// 商品实体类 @Data @TableName("product") public class Product { @TableId(type = IdType.AUTO) private Long id; @NotBlank(message = "商品名称不能为空") private String productName; @NotNull(message = "分类 ID 不能为空") private Long categoryId; @DecimalMin(value = "0.01", message = "商品价格必须大于 0") private BigDecimal price; @Min(value = 0, message = "库存数量不能为负数") private Integer stock; private Integer status; @TableField(fill = FieldFill.INSERT) private LocalDateTime createTime; @TableField(fill = FieldFill.INSERT_UPDATE) private LocalDateTime updateTime; } // 商品新增 DTO @Data public class ProductAddDTO { @NotBlank(message = "商品名称不能为空") private String productName; @NotNull(message = "分类 ID 不能为空") private Long categoryId; @DecimalMin(value = "0.01", message = "商品价格必须大于 0") private BigDecimal price; @Min(value = 0, message = "库存数量不能为负数") private Integer stock; } 

2.2.3 Service 层核心逻辑（含 AI 优化）

@Service @RequiredArgsConstructor public class ProductServiceImpl extends ServiceImpl<ProductMapper, Product> implements ProductService { private final ProductMapper productMapper; private final RedissonClient redissonClient; /** * 新增商品（AI 辅助自动生成，含唯一性校验） */ @Override @Transactional(rollbackFor = Exception.class) public Boolean addProduct(ProductAddDTO dto) { // 1. 验证商品名称唯一性（使用 Redis 分布式锁防止并发问题） RLock lock = redissonClient.getLock("product:name:lock:" + dto.getProductName()); lock.lock(5, TimeUnit.SECONDS); try { LambdaQueryWrapper<Product> queryWrapper = new LambdaQueryWrapper<>(); queryWrapper.eq(Product::getProductName, dto.getProductName()); if (baseMapper.exists(queryWrapper)) { throw new BusinessException("商品名称已存在"); } // 2. 转换 DTO 为实体类并保存 Product product = new Product(); BeanUtils.copyProperties(dto, product); product.setStatus(1); // 默认上架状态 return save(product); } finally { if (lock.isHeldByCurrentThread()) { lock.unlock(); } } } /** * 库存扣减（AI 辅助自动生成，含库存校验与乐观锁） */ @Override @Transactional(rollbackFor = Exception.class) public Boolean deductStock(Long productId, Integer quantity) { // 使用 MyBatis-Plus 乐观锁实现库存扣减，防止超卖 Product product = getById(productId); if (product == null) { throw new BusinessException("商品不存在"); } if (product.getStock() < quantity) { throw new BusinessException("库存不足，当前库存：" + product.getStock()); } Product updateProduct = new Product(); updateProduct.setId(productId); updateProduct.setStock(product.getStock() - quantity); // 乐观锁版本控制（需在实体类中添加@Version 注解） updateProduct.setVersion(product.getVersion()); int rows = baseMapper.updateById(updateProduct); if (rows == 0) { // 库存扣减失败，重试机制（AI 辅助自动添加） throw new RetryException("库存扣减冲突，请重试"); } return true; } /** * 按分类分页查询商品（AI 辅助自动生成，含 VO 转换） */ @Override public IPage<ProductVO> getProductByCategory(ProductQueryDTO dto) { // 分页查询（AI 辅助自动生成分页逻辑） Page<Product> page = new Page<>(dto.getPageNum(), dto.getPageSize()); LambdaQueryWrapper<Product> queryWrapper = new LambdaQueryWrapper<>(); queryWrapper.eq(Product::getCategoryId, dto.getCategoryId()) .eq(Product::getStatus, 1) // 只查询上架商品 .orderByDesc(Product::getCreateTime); IPage<Product> productPage = baseMapper.selectPage(page, queryWrapper); // 转换为 VO 返回（AI 辅助自动生成 VO 转换逻辑） return productPage.convert(product -> { ProductVO vo = new ProductVO(); BeanUtils.copyProperties(product, vo); // 补充分类名称（AI 辅助自动关联分类表查询） ProductCategory category = categoryMapper.selectById(product.getCategoryId()); vo.setCategoryName(category != null ? category.getCategoryName() : "未知分类"); return vo; }); } }

2.2.4 Controller 层 API（含 Swagger 文档）

@RestController @RequestMapping("/api/v1/product") @RequiredArgsConstructor @Tag(name = "商品管理接口", description = "电商商品 CRUD、库存管理接口") public class ProductController { private final ProductService productService; @PostMapping("/add") @Operation(summary = "新增商品", description = "新增商品，需保证商品名称唯一性") @ApiResponses({ @ApiResponse(responseCode = "200", description = "成功"), @ApiResponse(responseCode = "400", description = "参数错误：商品名称为空/价格小于 0 等"), @ApiResponse(responseCode = "500", description = "服务器错误") }) public Result<Boolean> addProduct(@Valid @RequestBody ProductAddDTO dto) { return Result.success(productService.addProduct(dto)); } @PostMapping("/deduct-stock") @Operation(summary = "库存扣减", description = "下单时扣减商品库存，返回是否成功") public Result<Boolean> deductStock(@RequestParam Long productId, @RequestParam Integer quantity) { return Result.success(productService.deductStock(productId, quantity)); } @GetMapping("/list-by-category") @Operation(summary = "按分类分页查询商品", description = "查询指定分类下的上架商品，支持分页") public Result<IPage<ProductVO>> getProductByCategory(ProductQueryDTO dto) { return Result.success(productService.getProductByCategory(dto)); } }

2.3 API 接口说明（AI 辅助自动生成文档）

三、订单管理模块开发（高并发场景）

订单模块是电商系统的核心交易环节，涉及订单创建、状态流转、超时关闭等关键功能，AI 辅助工具针对高并发场景提供了自动化的解决方案。

3.1 核心功能设计

基于 AI 辅助工具的'架构设计助手'，订单模块采用以下设计：

• 订单状态机：自动生成订单状态流转逻辑（待付款→已付款→已发货→已完成→已取消）
• 分布式事务：使用 Seata 实现订单创建与库存扣减的分布式事务一致性
• 超时处理：基于 RocketMQ 延迟队列实现订单超时自动关闭

3.2 核心代码实现（AI 辅助生成）

3.2.1 订单 Service 层核心逻辑

@Service @RequiredArgsConstructor public class OrderServiceImpl extends ServiceImpl<OrderMapper, Order> implements OrderService { private final ProductService productService; private final OrderItemService orderItemService; private final RocketMQTemplate rocketMQTemplate; private final IdGenerator idGenerator; // AI 辅助自动集成雪花 ID 生成器 /** * 创建订单（AI 辅助自动生成，含分布式事务） */ @Override @GlobalTransactional(rollbackFor = Exception.class) // Seata 分布式事务注解 public OrderVO createOrder(OrderCreateDTO dto) { // 1. 生成订单号（雪花 ID） String orderNo = idGenerator.nextIdStr(); // 2. 扣减商品库存（调用商品服务） boolean deductResult = productService.deductStock(dto.getProductId(), dto.getQuantity()); if (!deductResult) { throw new BusinessException("库存扣减失败"); } // 3. 查询商品信息 Product product = productService.getById(dto.getProductId()); if (product == null) { throw new BusinessException("商品不存在"); } // 4. 创建订单主表 Order order = new Order(); order.setOrderNo(orderNo); order.setUserId(dto.getUserId()); order.setTotalAmount(product.getPrice().multiply(new BigDecimal(dto.getQuantity()))); order.setPayAmount(order.getTotalAmount()); order.setOrderStatus(1); // 1-待付款 order.setPayStatus(0); // 0-未支付 save(order); // 5. 创建订单明细表 OrderItem orderItem = new OrderItem(); orderItem.setOrderId(order.getId()); orderItem.setProductId(product.getId()); orderItem.setProductName(product.getProductName()); orderItem.setUnitPrice(product.getPrice()); orderItem.setQuantity(dto.getQuantity()); orderItem.setTotalPrice(order.getTotalAmount()); orderItemService.save(orderItem); // 6. 发送延迟消息（订单超时关闭，延迟 30 分钟） sendOrderTimeoutMsg(orderNo); // 7. 转换为 VO 返回 OrderVO orderVO = new OrderVO(); BeanUtils.copyProperties(order, orderVO); orderVO.setOrderItemList(Collections.singletonList(orderItem)); return orderVO; } /** * 发送订单超时消息（AI 辅助自动生成延迟队列逻辑） */ private void sendOrderTimeoutMsg(String orderNo) { OrderTimeoutMsg msg = new OrderTimeoutMsg(); msg.setOrderNo(orderNo); msg.setCreateTime(LocalDateTime.now()); // 发送延迟消息（RocketMQ 延迟级别：18 代表 30 分钟） rocketMQTemplate.syncSend( "order-timeout-topic", MessageBuilder.withPayload(msg).build(), 3000, 18 ); } /** * 订单超时关闭（AI 辅助自动生成消费者逻辑） */ @Override @Transactional(rollbackFor = Exception.class) public void closeOrderTimeout(String orderNo) { // 查询订单（只处理待付款状态的订单） LambdaQueryWrapper<Order> queryWrapper = new LambdaQueryWrapper<>(); queryWrapper.eq(Order::getOrderNo, orderNo) .eq(Order::getOrderStatus, 1) // 1-待付款 .eq(Order::getPayStatus, 0); // 0-未支付 Order order = getOne(queryWrapper); if (order == null) { log.info("订单已处理，无需关闭：{}", orderNo); return; } // 更新订单状态为已取消 Order updateOrder = new Order(); updateOrder.setId(order.getId()); updateOrder.setOrderStatus(5); // 接上文订单超时关闭方法 updateOrder.setOrderStatus (5); // 5 - 已取消 updateOrder.setCancelTime (LocalDateTime.now ()); updateById (updateOrder); // 7. 恢复商品库存（订单取消后回补库存） OrderItem orderItem = orderItemService.getOne ( new LambdaWrapper().eq(OrderItem::getOrderId, order.getId()) ); if (orderItem != null) { productService.recoverStock(orderItem.getProductId(), orderItem.getQuantity()); log.info("订单超时关闭，库存已恢复：订单号={}, 商品 ID={}, 恢复数量={}", orderNo, orderItem.getProductId (), orderItem.getQuantity ()); } } /** * 订单状态流转（AI 辅助自动生成状态机逻辑） */ @Override @Transactional (rollbackFor = Exception.class) public Boolean updateOrderStatus (String orderNo, Integer targetStatus) { // 1. 校验订单状态合法性（基于状态机规则） Order order = getOne (new LambdaQueryWrapper().eq (Order::getOrderNo, orderNo)); if (order == null) { throw new BusinessException ("订单不存在"); } // 状态流转规则：待付款 (1)→已取消 (5)、待付款 (1)→已付款 (2)；已付款 (2)→已发货 (3)；已发货 (3)→已完成 (4) Map<Integer, List> statusFlow = new HashMap<>(); statusFlow.put(1, Arrays.asList(2, 5)); statusFlow.put(2, Collections.singletonList(3)); statusFlow.put(3, Collections.singletonList(4)); if (!statusFlow.getOrDefault (order.getOrderStatus (), Collections.emptyList ()).contains (targetStatus)) { throw new BusinessException ("非法状态流转：当前状态 =" + order.getOrderStatus () + ", 目标状态 =" + targetStatus); } // 2. 更新订单状态 Order updateOrder = new Order (); updateOrder.setId (order.getId ()); updateOrder.setOrderStatus (targetStatus); // 补充状态变更相关时间 if (targetStatus == 2) { // 已付款 updateOrder.setPayStatus (1); updateOrder.setPayTime (LocalDateTime.now ()); } else if (targetStatus == 3) { // 已发货 updateOrder.setShipTime (LocalDateTime.now ()); } else if (targetStatus == 4) { // 已完成 updateOrder.setFinishTime (LocalDateTime.now ()); } return updateById (updateOrder); } }

3.2.2 订单 Controller 层 API（AI 辅助生成）

@RestController @RequestMapping("/api/v1/order") @RequiredArgsConstructor @Tag(name = "订单管理接口", description = "电商订单创建、状态更新、查询接口") public class OrderController { private final OrderService orderService; @PostMapping("/create") @Operation(summary = "创建订单", description = "用户下单接口，含库存扣减与分布式事务") public Result<OrderVO> createOrder(@Valid @RequestBody OrderCreateDTO dto) { return Result.success(orderService.createOrder(dto)); } @PostMapping("/update-status") @Operation(summary = "更新订单状态", description = "支持待付款→已付款/已取消、已付款→已发货、已发货→已完成") @ApiResponses({ @ApiResponse(responseCode = "200", description = "成功"), @ApiResponse(responseCode = "400", description = "非法状态流转/订单不存在") }) public Result<Boolean> updateOrderStatus( @RequestParam String orderNo, @RequestParam Integer targetStatus) { return Result.success(orderService.updateOrderStatus(orderNo, targetStatus)); } @GetMapping("/detail") @Operation(summary = "查询订单详情", description = "根据订单号查询订单主信息与明细") public Result<OrderDetailVO> getOrderDetail(@RequestParam String orderNo) { return Result.success(orderService.getOrderDetail(orderNo)); } @GetMapping("/user/list") @Operation(summary = "用户订单列表", description = "查询指定用户的订单列表，支持分页与状态筛选") public Result<IPage<OrderVO>> getUserOrderList( @RequestParam Long userId, @RequestParam(required = false) Integer orderStatus, @RequestParam(defaultValue = "1") Integer pageNum, @RequestParam(defaultValue = "10") Integer pageSize) { OrderQueryDTO dto = new OrderQueryDTO(); dto.setUserId(userId); dto.setOrderStatus(orderStatus); dto.setPageNum(pageNum); dto.setPageSize(pageSize); return Result.success(orderService.getUserOrderList(dto)); } }

3.3 订单模块 API 说明

四、支付集成模块开发（安全合规）

支付模块是电商交易的关键闭环，需保障支付安全、资金合规与异步通知处理。AI 辅助工具已内置主流支付渠道（支付宝、微信支付）的集成模板，可快速实现支付流程开发。

4.1 支付流程设计

基于 AI 辅助工具的'支付方案助手'，采用以下标准化流程：

1. 支付发起：用户选择支付方式，系统生成支付参数（如支付宝支付链接、微信支付二维码）
2. 支付回调：支付渠道异步通知支付结果，系统验证签名并更新订单状态
3. 支付查询：提供主动查询接口，处理异步通知丢失场景
4. 退款处理：支持订单全额 / 部分退款，同步更新退款状态

4.2 核心代码实现（AI 辅助生成）

4.2.1 支付配置类（自动生成渠道配置）

@Configuration @ConfigurationProperties(prefix = "pay") @Data public class PayConfig { // 支付宝配置 private AlipayConfig alipay; // 微信支付配置 private WxPayConfig wxpay; @Data public static class AlipayConfig { private String appId; private String privateKey; private String publicKey; private String notifyUrl; // 异步通知地址 private String returnUrl; // 同步跳转地址 private String charset = "UTF-8"; private String signType = "RSA2"; private String gatewayUrl = "https://openapi.alipay.com/gateway.do"; } @Data public static class WxPayConfig { private String appId; private String mchId; private String mchKey; private String notifyUrl; private String tradeType = "NATIVE"; // 扫码支付 private String apiKey3; // 微信 V3 接口密钥 private String certPath; // 商户证书路径 } }

4.2.2 支付 Service 层核心逻辑

@Service @RequiredArgsConstructor public class PayServiceImpl implements PayService { private final PayConfig payConfig; private final OrderService orderService; private final PayRecordService payRecordService; private final AlipayClient alipayClient; // AI 辅助自动注入支付宝客户端 private final WxPayService wxPayService; // AI 辅助自动注入微信支付客户端 /** * 发起支付（AI 辅助自动生成多渠道适配逻辑） */ @Override @Transactional(rollbackFor = Exception.class) public PayVO createPay(PayCreateDTO dto) { // 1. 校验订单状态（仅待付款订单可发起支付） Order order = orderService.getOne( new LambdaQueryWrapper<Order>() .eq(Order::getOrderNo, dto.getOrderNo()) .eq(Order::getOrderStatus, 1) // 待付款 ); if (order == null) { throw new BusinessException("订单不存在或状态不允许支付"); } // 2. 生成支付记录 PayRecord payRecord = new PayRecord(); payRecord.setPayNo(generatePayNo()); // 生成唯一支付单号 payRecord.setOrderNo(dto.getOrderNo()); payRecord.setUserId(order.getUserId()); payRecord.setPayAmount(order.getPayAmount()); payRecord.setPayType(dto.getPayType()); // 1-支付宝，2-微信支付 payRecord.setPayStatus(0); // 0-未支付 payRecordService.save(payRecord); // 3. 适配不同支付渠道 if (dto.getPayType() == 1) { // 支付宝支付 return createAlipay(payRecord, order); } else if (dto.getPayType() == 2) { // 微信支付 return createWxPay(payRecord, order); } else { throw new BusinessException("不支持的支付方式"); } } /** * 支付宝支付参数生成（AI 辅助自动集成支付宝 SDK） */ private PayVO createAlipay(PayRecord payRecord, Order order) { try { AlipayTradePagePayRequest request = new AlipayTradePagePayRequest(); request.setReturnUrl(payConfig.getAlipay().getReturnUrl()); request.setNotifyUrl(payConfig.getAlipay().getNotifyUrl()); // 构建支付请求参数 JSONObject bizContent = new JSONObject(); bizContent.put("out_trade_no", payRecord.getPayNo()); // 商户支付单号 bizContent.put("total_amount", order.getPayAmount().toString()); // 支付金额 bizContent.put("subject", "订单支付-" + order.getOrderNo()); // 订单标题 bizContent.put("product_code", "FAST_INSTANT_TRADE_PAY"); // 支付宝产品码 request.setBizContent(bizContent.toString()); // 调用支付宝接口生成支付链接 AlipayTradePagePayResponse response = alipayClient.pageExecute(request); if (response.isSuccess()) { PayVO payVO = new PayVO(); payVO.setPayNo(payRecord.getPayNo()); payVO.setPayUrl(response.getBody()); // 支付宝支付表单 HTML return payVO; } else { throw new BusinessException("支付宝支付参数生成失败：" + response.getMsg()); } } catch (AlipayApiException e) { log.error("支付宝支付异常", e); throw new BusinessException("支付发起失败，请重试"); } } /** * 微信支付参数生成（AI 辅助自动集成微信支付 SDK） */ private PayVO createWxPay(PayRecord payRecord, Order order) { try { WxPayUnifiedOrderRequest request = new WxPayUnifiedOrderRequest(); request.setBody("订单支付-" + order.getOrderNo()); // 商品描述 request.setOutTradeNo(payRecord.getPayNo()); // 商户支付单号 request.setTotalFee(order.getPayAmount().multiply(new BigDecimal(100)).intValue()); // 金额（分） request.setSpbillCreateIp(WebUtils.getClientIp()); // 客户端 IP request.setNotifyUrl(payConfig.getWxpay().getNotifyUrl()); request.setTradeType(payConfig.getWxpay().getTradeType()); // 调用微信接口生成支付二维码 WxPayUnifiedOrderResult result = wxPayService.unifiedOrder(request); if ("SUCCESS".equals(result.getReturnCode()) && "SUCCESS".equals(result.getResultCode())) { PayVO payVO = new PayVO(); payVO.setPayNo(payRecord.getPayNo()); payVO.setQrCodeUrl(result.getCodeUrl()); // 微信支付二维码地址 return payVO; } else { throw new BusinessException("微信支付参数生成失败：" + result.getReturnMsg()); } } catch (WxPayException e) { log.error("微信支付异常", e); throw new BusinessException("支付发起失败，请重试"); } } /** * 支付回调处理（AI 辅助自动生成签名验证与状态更新逻辑） */ @Override @Transactional(rollbackFor = Exception.class) public String handlePayNotify(Integer payType, Map<String, String> params) { // 1. 签名验证（不同渠道验证逻辑不同） boolean signValid = false; if (payType == 1) { // 支付宝回调 signValid = AlipaySignature.rsaCheckV1( params, payConfig.getAlipay().getPublicKey(), payConfig.getAlipay().getCharset(), payConfig.getAlipay().getSignType() ); } else if (payType == 2) { // 微信支付回调 try { signValid = wxPayService.verifyNotifySign(params); } catch (WxPayException e) { log.error("微信支付回调签名验证失败", e); return "fail"; } } if (!signValid) { log.warn("支付回调签名验证失败：payType={}, params={}", payType, params); return "fail"; } // 2. 解析回调参数，更新支付记录与订单状态 String payNo = params.get(payType == 1 ? "out_trade_no" : "out_trade_no"); // 商户支付单号 String tradeNo = params.get(payType == 1 ? "trade_no" : "transaction_id"); // 渠道交易号 String tradeStatus = params.get(payType == 1 ? "trade_status" : "result_code"); // 支付状态 // 校验支付状态（支付宝 TRADE_SUCCESS/微信 SUCCESS 为支付成功） boolean paySuccess = (payType == 1 && "TRADE_SUCCESS".equals(tradeStatus)) || (payType == 2 && "SUCCESS".equals(tradeStatus)); if (paySuccess) { // 更新支付记录 PayRecord payRecord = payRecordService.getOne(new LambdaQueryWrapper<PayRecord>().eq(PayRecord::getPayNo, payNo)); if (payRecord == null || payRecord.getPayStatus() == 1) { return payType == 1 ? "success" : "<xml><return_code><![CDATA[SUCCESS]]></return_code></xml>"; } payRecord.setPayStatus(1); // 1-已支付 payRecord.setTradeNo(tradeNo); payRecord.setPayTime(LocalDateTime.now()); payRecordService.updateById(payRecord); // 更新订单状态为已付款 orderService.updateOrderStatus(payRecord.getOrderNo(), 2); log.info("支付成功，已更新订单状态：payNo={}, orderNo={}", payNo, payRecord.getOrderNo()); } // 3. 返回回调结果（按渠道要求格式返回） return payType == 1 ? "success" : "<xml><return_code><![CDATA[SUCCESS]]></return_code></xml>"; } /** * 生成唯一支付单号（雪花 ID+ 支付类型） */ private String generatePayNo() { return "P" + System.currentTimeMillis() + RandomUtils.nextInt(1000, 9999); } /** * 支付结果查询（AI 辅助自动生成多渠道查询逻辑） */ @Override public PayStatusVO queryPayStatus (String payNo) { // 1. 查询支付记录 PayRecord payRecord = payRecordService.getOne ( new LambdaQueryWrapper().eq (PayRecord::getPayNo, payNo) ); if (payRecord == null) { throw new BusinessException ("支付记录不存在"); } // 2. 若已支付，直接返回结果 if (payRecord.getPayStatus () == 1) { PayStatusVO statusVO = new PayStatusVO (); statusVO.setPayNo (payNo); statusVO.setOrderNo (payRecord.getOrderNo ()); statusVO.setPayStatus (1); statusVO.setPayTime (payRecord.getPayTime ()); statusVO.setTradeNo (payRecord.getTradeNo ()); return statusVO; } // 3. 未支付，调用渠道接口查询最新状态 if (payRecord.getPayType () == 1) { // 支付宝查询 return queryAlipayStatus (payRecord); } else if (payRecord.getPayType () == 2) { // 微信支付查询 return queryWxPayStatus (payRecord); } else { throw new BusinessException ("不支持的支付方式"); } } /** * 支付宝支付状态查询 */ private PayStatusVO queryAlipayStatus (PayRecord payRecord) { try { AlipayTradeQueryRequest request = new AlipayTradeQueryRequest (); JSONObject bizContent = new JSONObject (); bizContent.put ("out_trade_no", payRecord.getPayNo ()); // 商户支付单号 request.setBizContent (bizContent.toString ()); AlipayTradeQueryResponse response = alipayClient.execute (request); if (response.isSuccess ()) { PayStatusVO statusVO = new PayStatusVO (); statusVO.setPayNo (payRecord.getPayNo ()); statusVO.setOrderNo (payRecord.getOrderNo ()); // 解析支付宝支付状态（TRADE_SUCCESS 为支付成功） String tradeStatus = response.getTradeStatus (); statusVO.setPayStatus ("TRADE_SUCCESS".equals (tradeStatus) ? 1 : 0); if ("TRADE_SUCCESS".equals (tradeStatus)) { statusVO.setPayTime (LocalDateTime.parse ( response.getGmtPayment (), DateTimeFormatter.ofPattern ("yyyy-MM-dd HH:mm:ss"))); statusVO.setTradeNo (response.getTradeNo ()); // 更新本地支付记录状态 payRecord.setPayStatus (1); payRecord.setTradeNo (response.getTradeNo ()); payRecord.setPayTime (statusVO.getPayTime ()); payRecordService.updateById (payRecord); // 同步更新订单状态 orderService.updateOrderStatus (payRecord.getOrderNo (), 2); } return statusVO; } else { throw new BusinessException ("支付宝状态查询失败：" + response.getMsg ()); } } catch (AlipayApiException e) { log.error ("支付宝查询异常", e); throw new BusinessException ("支付状态查询失败，请重试"); } } /** * 微信支付状态查询 */ private PayStatusVO queryWxPayStatus (PayRecord payRecord) { try { WxPayOrderQueryRequest request = new WxPayOrderQueryRequest (); request.setOutTradeNo (payRecord.getPayNo ()); // 商户支付单号 WxPayOrderQueryResult result = wxPayService.queryOrder (request); if ("SUCCESS".equals (result.getReturnCode ()) && "SUCCESS".equals (result.getResultCode ())) { PayStatusVO statusVO = new PayStatusVO (); statusVO.setPayNo (payRecord.getPayNo ()); statusVO.setOrderNo (payRecord.getOrderNo ()); // 解析微信支付状态（SUCCESS 为支付成功） statusVO.setPayStatus ("SUCCESS".equals (result.getTradeState ()) ? 1 : 0); if ("SUCCESS".equals (result.getTradeState ())) { statusVO.setPayTime (LocalDateTime.parse ( result.getTimeEnd (), DateTimeFormatter.ofPattern ("yyyyMMddHHmmss"))); statusVO.setTradeNo (result.getTransactionId ()); // 更新本地支付记录状态 payRecord.setPayStatus (1); payRecord.setTradeNo (result.getTransactionId ()); payRecord.setPayTime (statusVO.getPayTime ()); payRecordService.updateById (payRecord); // 同步更新订单状态 orderService.updateOrderStatus (payRecord.getOrderNo (), 2); } return statusVO; } else { throw new BusinessException ("微信支付状态查询失败：" + result.getReturnMsg ()); } } catch (WxPayException e) { log.error ("微信支付查询异常", e); throw new BusinessException ("支付状态查询失败，请重试"); } } /** * 订单退款（AI 辅助自动生成多渠道退款逻辑） */ @Override @Transactional (rollbackFor = Exception.class) public RefundVO createRefund (RefundCreateDTO dto) { // 1. 校验订单与支付记录状态 Order order = orderService.getOne ( new LambdaQueryWrapper() .eq (Order::getOrderNo, dto.getOrderNo ()) .eq (Order::getOrderStatus, 2) // 仅已付款订单可退款 ); if (order == null) { throw new BusinessException ("订单不存在或状态不允许退款"); } PayRecord payRecord = payRecordService.getOne( new LambdaQueryWrapper() .eq (PayRecord::getOrderNo, dto.getOrderNo ()) .eq (PayRecord::getPayStatus, 1) // 已支付 ); if (payRecord == null) { throw new BusinessException ("支付记录不存在，无法退款"); } // 2. 校验退款金额（不超过支付金额） if (dto.getRefundAmount ().compareTo (payRecord.getPayAmount ()) > 0) { throw new BusinessException ("退款金额不能超过支付金额：" + payRecord.getPayAmount ()); } // 3. 生成退款记录 RefundRecord refundRecord = new RefundRecord (); refundRecord.setRefundNo (generateRefundNo ()); // 唯一退款单号 refundRecord.setOrderNo (dto.getOrderNo ()); refundRecord.setPayNo (payRecord.getPayNo ()); refundRecord.setRefundAmount (dto.getRefundAmount ()); refundRecord.setRefundReason (dto.getRefundReason ()); refundRecord.setRefundStatus (0); // 0 - 退款中 refundRecordService.save (refundRecord); // 4. 调用渠道退款接口 if (payRecord.getPayType () == 1) { // 支付宝退款 return createAlipayRefund (refundRecord, payRecord); } else if (payRecord.getPayType () == 2) { // 微信支付退款 return createWxPayRefund (refundRecord, payRecord); } else { throw new BusinessException ("不支持的支付方式"); } } /** * 支付宝退款 */ private RefundVO createAlipayRefund (RefundRecord refundRecord, PayRecord payRecord) { try { AlipayTradeRefundRequest request = new AlipayTradeRefundRequest (); JSONObject bizContent = new JSONObject (); bizContent.put ("out_trade_no", payRecord.getPayNo ()); // 商户支付单号 bizContent.put ("out_request_no", refundRecord.getRefundNo ()); // 退款单号 bizContent.put ("refund_amount", refundRecord.getRefundAmount ().toString ()); // 退款金额 bizContent.put ("refund_reason", refundRecord.getRefundReason ()); // 退款原因 request.setBizContent (bizContent.toString ()); AlipayTradeRefundResponse response = alipayClient.execute (request); if (response.isSuccess ()) { RefundVO refundVO = new RefundVO (); refundVO.setRefundNo (refundRecord.getRefundNo ()); refundVO.setOrderNo (refundRecord.getOrderNo ()); refundVO.setRefundAmount (refundRecord.getRefundAmount ()); refundVO.setRefundStatus (1); // 1 - 退款成功 refundVO.setRefundTime (LocalDateTime.now ()); refundVO.setTradeNo (response.getTradeNo ()); refundVO.setRefundTradeNo (response.getRefundTradeNo ()); // 更新退款记录状态 refundRecord.setRefundStatus (1); refundRecord.setRefundTime (refundVO.getRefundTime ()); refundRecord.setRefundTradeNo (response.getRefundTradeNo ()); refundRecordService.updateById (refundRecord); // 更新订单状态为已退款 orderService.updateOrderStatus (refundRecord.getOrderNo (), 6); // 6 - 已退款 return refundVO; } else { throw new BusinessException ("支付宝退款失败：" + response.getMsg ()); } } catch (AlipayApiException e) { log.error ("支付宝退款异常", e); // 更新退款记录为失败状态 refundRecord.setRefundStatus (2); // 2 - 退款失败 refundRecord.setFailReason (e.getMessage ()); refundRecordService.updateById (refundRecord); throw new BusinessException ("退款发起失败，请重试"); } } /** * 微信支付退款 */ private RefundVO createWxPayRefund (RefundRecord refundRecord, PayRecord payRecord) { try { WxPayRefundRequest request = new WxPayRefundRequest (); request.setOutTradeNo (payRecord.getPayNo ()); // 商户支付单号 request.setOutRefundNo (refundRecord.getRefundNo ()); // 退款单号 // 微信金额单位为分，需转换 request.setTotalFee (payRecord.getPayAmount ().multiply (new BigDecimal (100)).intValue ()); request.setRefundFee (refundRecord.getRefundAmount ().multiply (new BigDecimal (100)).intValue ()); request.setRefundDesc (refundRecord.getRefundReason ()); // 退款原因 WxPayRefundResult result = wxPayService.refund (request); if ("SUCCESS".equals (result.getReturnCode ()) && "SUCCESS".equals (result.getResultCode ())) { RefundVO refundVO = new RefundVO (); refundVO.setRefundNo (refundRecord.getRefundNo ()); refundVO.setOrderNo (refundRecord.getOrderNo ()); refundVO.setRefundAmount (refundRecord.getRefundAmount ()); refundVO.setRefundStatus (1); // 1 - 退款成功 refundVO.setRefundTime (LocalDateTime.now ()); refundVO.setTradeNo (result.getTransactionId ()); refundVO.setRefundTradeNo (result.getRefundId ()); // 更新退款记录状态 refundRecord.setRefundStatus (1); refundRecord.setRefundTime (refundVO.getRefundTime ()); refundRecord.setRefundTradeNo (result.getRefundId ()); refundRecordService.updateById (refundRecord); // 更新订单状态为已退款 orderService.updateOrderStatus (refundRecord.getOrderNo (), 6); // 6 - 已退款 return refundVO; } else { throw new BusinessException ("微信支付退款失败：" + result.getReturnMsg ()); } } catch (WxPayException e) { log.error ("微信支付退款异常", e); // 更新退款记录为失败状态 refundRecord.setRefundStatus (2); // 2 - 退款失败 refundRecord.setFailReason (e.getMessage ()); refundRecordService.updateById (refundRecord); throw new BusinessException ("退款发起失败，请重试"); } } /** * 生成唯一退款单号 */ private String generateRefundNo () { return "R" + System.currentTimeMillis() + RandomUtils.nextInt (1000, 9999); } }

4.2.3 支付 Controller 层 API（AI 辅助生成）

@RestController @RequestMapping("/api/v1/pay") @RequiredArgsConstructor @Tag(name = "支付管理接口", description = "电商支付发起、回调、查询、退款接口") public class PayController { private final PayService payService; @PostMapping("/create") @Operation(summary = "发起支付", description = "支持支付宝（1）、微信支付（2），返回支付参数") @ApiResponses({ @ApiResponse(responseCode = "200", description = "成功"), @ApiResponse(responseCode = "400", description = "订单状态异常/不支持的支付方式") }) public Result<PayVO> createPay(@Valid @RequestBody PayCreateDTO dto) { return Result.success(payService.createPay(dto)); } @PostMapping("/notify/alipay") @Operation(summary = "支付宝支付回调", description = "支付宝异步通知支付结果，需返回 success/fail") public String alipayNotify(HttpServletRequest request) { // 解析支付宝回调参数 Map<String, String> params = new HashMap<>(); Enumeration<String> parameterNames = request.getParameterNames(); while (parameterNames.hasMoreElements()) { String name = parameterNames.nextElement(); params.put(name, request.getParameter(name)); } // 处理回调逻辑 return payService.handlePayNotify(1, params); } @PostMapping("/notify/wxpay") @Operation(summary = "微信支付回调", description = "微信支付异步通知支付结果，需返回 XML 格式结果") public String wxpayNotify(HttpServletRequest request) { try { // 解析微信回调 XML 参数 String xml = IOUtils.toString(request.getInputStream(), StandardCharsets.UTF_8); Map<String, String> params = WxPayXmlUtil.xmlToMap(xml); // 处理回调逻辑 return payService.handlePayNotify(2, params); } catch (IOException e) { log.error("微信支付回调参数解析失败", e); return "<xml><return_code><![CDATA[FAIL]]></return_code><return_msg><![CDATA[参数解析失败]]></return_msg></xml>"; } } @GetMapping("/query-status") @Operation(summary = "查询支付状态", description = "根据支付单号查询最新支付状态，支持主动补偿") public Result<PayStatusVO> queryPayStatus(@RequestParam String payNo) { return Result.success(payService.queryPayStatus(payNo)); } @PostMapping("/refund") @Operation(summary = "发起退款", description = "仅已付款订单可发起退款，支持全额/部分退款") @ApiResponses({ @ApiResponse(responseCode = "200", description = "成功"), @ApiResponse(responseCode = "400", description = "订单状态异常/退款金额超限") }) public Result<RefundVO> createRefund(@Valid @RequestBody RefundCreateDTO dto) { return Result.success(payService.createRefund(dto)); } @GetMapping("/refund/query") @Operation(summary = "查询退款状态", description = "根据退款单号查询退款进度") public Result<RefundVO> queryRefundStatus(@RequestParam String refundNo) { return Result.success(payService.queryRefundStatus(refundNo)); } }

4.3 支付模块 API 说明

五、AI 辅助电商开发核心优势总结

通过商品管理、订单管理、支付集成三大核心模块的实战开发，AI 辅助工具展现出对电商系统开发全流程的深度赋能，其核心优势可归纳为以下四点：

5.1 开发效率指数级提升

传统电商模块开发中，从需求分析到代码实现需手动完成表结构设计、实体类定义、业务逻辑编写、API 封装等大量重复性工作，一个核心模块开发周期通常需 3-5 个工作日。而 AI 辅助工具凭借'自然语言转代码'能力，仅需输入清晰的需求描述，即可在分钟级生成完整的代码链路，包括数据库脚本、实体类、Service 层逻辑、Controller 接口及 Swagger 文档。以商品管理模块为例，AI 辅助工具可自动完成库存扣减的分布式锁实现、分页查询的 VO 转换、参数校验注解配置等细节工作，将模块开发周期缩短至 1 个工作日以内，整体效率提升超 60%。

同时，AI 辅助工具内置电商领域专属模板，针对商品上下架、订单状态流转、支付渠道集成等高频场景，提供标准化的代码生成方案，开发者无需从零构建架构，只需基于生成的代码进行少量业务调整，进一步降低开发成本。

5.2 高并发场景自动化适配

电商系统在大促活动（如 618、双 11）中面临海量并发请求，传统开发需手动设计分布式锁、延迟队列、乐观锁等解决方案，且需反复进行压力测试与优化。AI 辅助工具基于对电商高并发场景的深度理解，在代码生成阶段即自动嵌入成熟的高可用方案：

• 库存安全：商品库存扣减逻辑中自动集成 Redisson 分布式锁与 MyBatis-Plus 乐观锁，防止超卖与并发冲突；
• 订单可靠性：订单创建后自动通过 RocketMQ 延迟队列实现超时关闭，避免订单状态异常；
• 分布式事务：订单与库存操作间自动引入 Seata 分布式事务注解，保障跨服务数据一致性。

这些自动化适配的方案均经过大量电商实战验证，可直接应对每秒 thousands of requests（QPS）的并发压力，减少开发者 80% 以上的高并发场景优化工作量。

5.3 安全合规内置保障

支付模块作为电商系统的资金核心，需严格遵守支付行业安全规范（如 PCI DSS 合规），传统开发中需手动实现签名验证、敏感数据加密、回调参数防篡改等安全逻辑，易因代码疏漏引发安全风险。AI 辅助工具在支付模块开发中，自动内置全方位安全保障：

• 签名校验：支付宝、微信支付回调处理中，自动调用官方 SDK 进行签名验证，拒绝非法回调请求；
• 数据加密：支付单号、交易号等敏感信息在日志打印时自动脱敏，避免数据泄露；
• 参数校验：支付金额、退款金额等关键参数自动添加范围校验，防止恶意参数注入；
• 合规适配：遵循支付渠道接口规范，自动处理参数格式、编码格式（如微信支付 XML 格式、支付宝 JSON 格式），避免因接口适配问题导致的资金风险。

此外，AI 辅助工具生成的代码会自动引入 Spring Security 权限拦截逻辑，仅允许已认证用户发起支付、退款操作，进一步强化系统安全边界。

5.4 全链路可扩展性支持

电商业务需求迭代迅速，如新增支付渠道（如银联支付）、扩展商品属性（如多规格 SKU）等，传统开发需修改大量现有代码，易引发'牵一发而动全身'的问题。AI 辅助工具生成的代码遵循'开闭原则'，具备极强的可扩展性：

• 模块化设计：商品、订单、支付模块边界清晰，通过接口定义实现模块解耦，新增功能只需新增实现类，无需修改原有代码；
• 渠道适配接口化：支付模块中，支付宝、微信支付逻辑通过统一的 PayService 接口封装，新增银联支付时，只需实现 createUnionpay()、queryUnionpayStatus() 等方法，即可快速集成；
• 配置化管理：数据库连接、支付渠道密钥、缓存过期时间等参数均通过配置文件管理，环境切换或参数调整时，无需修改代码，直接修改配置即可生效。

这种可扩展性设计，使电商系统能够快速响应业务变化，新功能迭代周期从传统的 1-2 周缩短至 1-3 天。

六、总结与展望

本文通过实战案例详细讲解了如何利用 AI 辅助工具开发电商系统的商品、订单、支付三大核心模块，从代码生成、高并发适配、安全合规到可扩展性设计，全方位展现了 AI 辅助工具对电商开发流程的革新。相比传统开发模式，AI 辅助工具不仅大幅提升开发效率，更通过内置的行业最佳实践，保障系统的稳定性与安全性，让开发者能够将更多精力聚焦于业务创新而非重复性编码。

未来，随着 AI 辅助工具在电商领域的持续深耕，其将进一步整合 AI 自动化测试、智能监控告警、灰度发布等能力，构建'需求 - 开发 - 测试 - 部署'全流程的智能化开发体系。对于电商企业而言，借助 AI 辅助工具可快速搭建高可用、高并发的电商系统，在激烈的市场竞争中抢占先机；对于开发者而言，AI 辅助工具将成为提升开发能力、降低技术门槛的重要工具，推动电商开发行业迈向更高效、更智能的新阶段.