feat(core): 增强文件上传配置和异常处理

- 配置文件上传大小限制,单个文件最大10MB,请求最大50MB
- 添加文件写入磁盘阈值配置,超过2MB写入临时文件
- 实现文件上传超限异常处理,返回友好提示信息
- 优化应用启动日志,显示访问地址和运行环境信息
- 增加支付订单查询和更新的日志记录
- 创建阿里云OSS配置属性类,统一管理OSS参数
- 添加业务异常类,支持自定义错误码和消息
- 完善系统架构文档,描述前后端包结构和核心组件
- 新增商品创建请求DTO,支持SKU列表和校验规则
- 添加风控相关的客户信息和商品信息DTO
- 配置Logback日志框架,支持不同环境的日志输出策略
This commit is contained in:
2025-12-19 16:52:28 +08:00
parent 3eaa9a44bd
commit 8cfe9e00e0
11 changed files with 663 additions and 5 deletions

View File

@@ -1,13 +1,42 @@
package com.mtkj.mtpay;
import lombok.extern.slf4j.Slf4j;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.core.env.Environment;
@Slf4j
@SpringBootApplication
public class MtPayApplication {
public static void main(String[] args) {
SpringApplication.run(MtPayApplication.class, args);
try {
SpringApplication app = new SpringApplication(MtPayApplication.class);
Environment env = app.run(args).getEnvironment();
String applicationName = env.getProperty("spring.application.name", "mt-pay");
String serverPort = env.getProperty("server.port", "8080");
String contextPath = env.getProperty("server.servlet.context-path", "");
String activeProfiles = String.join(",", env.getActiveProfiles());
log.info("""
========================================
应用启动成功!
========================================
应用名称: {}
运行环境: {}
访问地址: http://localhost:{}{}
========================================
""",
applicationName,
activeProfiles.isEmpty() ? "default" : activeProfiles,
serverPort,
contextPath);
} catch (Exception e) {
log.error("应用启动失败", e);
throw e;
}
}
}

View File

@@ -0,0 +1,35 @@
package com.mtkj.mtpay.config;
import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
/**
* 阿里云OSS配置属性
*/
@Data
@Component
@ConfigurationProperties(prefix = "aliyun.oss")
public class AliyunOSSProperties {
/**
* AccessKeyId
*/
private String accessId;
/**
* AccessKeySecret
*/
private String accessKey;
/**
* Endpoint地域节点
*/
private String endpoint;
/**
* Bucket名称
*/
private String bucketName;
}

View File

@@ -0,0 +1,123 @@
package com.mtkj.mtpay.dto.request;
import jakarta.validation.Valid;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Size;
import lombok.Data;
import java.io.Serializable;
import java.math.BigDecimal;
import java.util.List;
/**
* 创建商品请求DTO
*/
@Data
public class CreateProductRequestDTO implements Serializable {
/**
* 商品名称
*/
@NotBlank(message = "商品名称不能为空")
@Size(max = 255, message = "商品名称长度不能超过255")
private String name;
/**
* 商品价格(基础价格)
*/
@NotNull(message = "商品价格不能为空")
private BigDecimal price;
/**
* 主图URL
*/
@Size(max = 4000, message = "主图URL长度不能超过4000")
private String mainImage;
/**
* 商品状态ACTIVE-上架INACTIVE-下架
*/
private String status = "ACTIVE";
/**
* 店铺ID
*/
@NotNull(message = "店铺ID不能为空")
private Long shopId;
/**
* SKU列表
*/
@Valid
@NotNull(message = "SKU列表不能为空")
@Size(min = 1, message = "至少需要一个SKU")
private List<CreateProductSkuDTO> skus;
/**
* SKU DTO
*/
@Data
public static class CreateProductSkuDTO implements Serializable {
/**
* SKU编码
*/
@NotBlank(message = "SKU编码不能为空")
@Size(max = 2000, message = "SKU编码长度不能超过2000")
private String sku;
/**
* 价格
*/
@NotNull(message = "SKU价格不能为空")
private BigDecimal price;
/**
* 货币ISO 4217三位币种代码
*/
@NotBlank(message = "货币不能为空")
@Size(min = 3, max = 3, message = "货币必须为3位ISO 4217代码")
private String currency = "USD";
/**
* 库存数量
*/
@NotNull(message = "库存数量不能为空")
private Integer stock = 0;
/**
* 销售属性JSON格式
*/
private String salesAttrs;
/**
* SKU图片URL
*/
@Size(max = 4000, message = "SKU图片URL长度不能超过4000")
private String skuImage;
/**
* 重量(单位:克)
*/
private BigDecimal weight;
/**
* 大小/尺寸JSON格式
*/
@Size(max = 200, message = "尺寸JSON长度不能超过200")
private String size;
/**
* 规格(文本描述)
*/
@Size(max = 2000, message = "规格长度不能超过2000")
private String specification;
/**
* SKU状态ACTIVE-启用INACTIVE-禁用
*/
private String status = "ACTIVE";
}
}

View File

@@ -0,0 +1,71 @@
package com.mtkj.mtpay.dto.risk;
import lombok.Data;
import java.io.Serializable;
/**
* 客户信息DTO
*/
@Data
public class CustomerDTO implements Serializable {
private String customerId;
private String firstName;
private String lastName;
private String email;
private String domain;
private String phone;
private String mobile;
private String workPhone;
private String identificationType;
private String identificationId;
private String registerTime;
private String registerIp;
private String registerTerminal;
private String registerCountry;
private String registerRange;
private String orderTime;
private String orderIp;
private String orderCountry;
private String payIp;
private String payCountry;
private String loginTime;
private String loginIp;
private String lastPayTime;
private String acquisitionChannel;
private String firstOrder;
private String nonMemberOrder;
private String preferentialOrder;
private String birthDate;
private String customerStatus;
}

View File

@@ -0,0 +1,27 @@
package com.mtkj.mtpay.dto.risk;
import lombok.Data;
import java.io.Serializable;
/**
* 商品信息DTO
*/
@Data
public class GoodsDTO implements Serializable {
private String name;
private String description;
private String sku;
private String averageUnitPrice;
private String number;
private String virtualProduct;
private String imgUrl;
}

View File

@@ -0,0 +1,34 @@
package com.mtkj.mtpay.exception;
import com.mtkj.mtpay.common.ResultCode;
import lombok.Getter;
/**
* 业务异常
*/
@Getter
public class BusinessException extends RuntimeException {
private final String code;
public BusinessException(String message) {
super(message);
this.code = ResultCode.FAIL.getCode();
}
public BusinessException(String code, String message) {
super(message);
this.code = code;
}
public BusinessException(ResultCode resultCode) {
super(resultCode.getMessage());
this.code = resultCode.getCode();
}
public BusinessException(ResultCode resultCode, String message) {
super(message);
this.code = resultCode.getCode();
}
}

View File

@@ -8,6 +8,7 @@ import org.springframework.validation.FieldError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.web.multipart.MaxUploadSizeExceededException;
import java.util.HashMap;
import java.util.Map;
@@ -45,6 +46,17 @@ public class GlobalExceptionHandler {
.body(Result.fail(ResultCode.VALIDATION_ERROR.getCode(), ResultCode.VALIDATION_ERROR.getMessage(), errors));
}
/**
* 处理文件上传大小超限异常
*/
@ExceptionHandler(MaxUploadSizeExceededException.class)
public ResponseEntity<Result<Object>> handleMaxUploadSizeExceededException(MaxUploadSizeExceededException e) {
log.warn("文件上传大小超限: {}", e.getMessage());
String message = "文件大小超过限制单个文件最大10MB请压缩后重试";
return ResponseEntity.badRequest()
.body(Result.fail(ResultCode.PARAM_ERROR.getCode(), message));
}
/**
* 处理运行时异常
*/

View File

@@ -41,6 +41,7 @@ public class PaymentOrderServiceImpl implements PaymentOrderService {
request.getMerchantTransactionId()
);
if (existingOrder.isPresent()) {
log.warn("订单号已存在,商户订单号: {}", request.getMerchantTransactionId());
throw new BusinessException(ResultCode.ORDER_EXISTS);
}
@@ -93,29 +94,49 @@ public class PaymentOrderServiceImpl implements PaymentOrderService {
@Override
public Optional<PaymentOrder> findByMerchantTransactionId(String merchantTransactionId) {
return paymentOrderMapper.findByMerchantTransactionId(merchantTransactionId);
log.debug("查询支付订单,商户订单号: {}", merchantTransactionId);
Optional<PaymentOrder> order = paymentOrderMapper.findByMerchantTransactionId(merchantTransactionId);
if (order.isPresent()) {
log.debug("找到支付订单,商户订单号: {}, 订单状态: {}", merchantTransactionId, order.get().getStatus());
} else {
log.debug("未找到支付订单,商户订单号: {}", merchantTransactionId);
}
return order;
}
@Override
public Optional<PaymentOrder> findByTransactionId(String transactionId) {
return paymentOrderMapper.findByTransactionId(transactionId);
log.debug("查询支付订单PingPong交易流水号: {}", transactionId);
Optional<PaymentOrder> order = paymentOrderMapper.findByTransactionId(transactionId);
if (order.isPresent()) {
log.debug("找到支付订单PingPong交易流水号: {}, 订单状态: {}", transactionId, order.get().getStatus());
} else {
log.debug("未找到支付订单PingPong交易流水号: {}", transactionId);
}
return order;
}
@Override
@Transactional
public PaymentOrder updateOrderStatus(String merchantTransactionId, String status, String transactionId) {
log.info("更新订单状态,商户订单号: {}, 新状态: {}, PingPong交易流水号: {}",
merchantTransactionId, status, transactionId);
Optional<PaymentOrder> orderOpt = paymentOrderMapper.findByMerchantTransactionId(merchantTransactionId);
if (orderOpt.isEmpty()) {
log.warn("订单不存在,无法更新状态,商户订单号: {}", merchantTransactionId);
throw new BusinessException(ResultCode.ORDER_NOT_FOUND);
}
PaymentOrder order = orderOpt.get();
String oldStatus = order.getStatus();
order.setStatus(status);
if (transactionId != null && !transactionId.isEmpty()) {
order.setTransactionId(transactionId);
}
paymentOrderMapper.updateById(order);
log.info("订单状态更新成功,商户订单号: {}, 原状态: {}, 新状态: {}",
merchantTransactionId, oldStatus, status);
return order;
}
}