当前位置：首页 > news >正文

Spring EL实战：多对象入参实现优惠券动态可用规则校验

news 2026/6/16 9:17:50

一、业务背景：传统优惠券规则有多痛苦？

电商系统优惠券场景，规则五花八门、迭代极快：

满减门槛：订单金额≥99 元可用、≥199 元可用
用户限制：仅新用户 / 会员等级≥3 级可用、黑名单用户禁用
时间限制：仅限活动期、下单时间在券有效期内
商品限制：优惠券限定类目，订单商品需匹配类目
叠加 / 库存限制：优惠券剩余使用次数大于 0、不可与其他券叠加

传统硬编码方案痛点

业务规则写死在if/else、枚举、业务代码中：

新增优惠券规则、修改门槛必须改代码、重启服务、灰度发布

规则耦合业务代码，代码臃肿，大量重复判断逻辑

运营配置优惠券、临时调整活动规则，依赖研发排期，效率极低

规则版本难追溯，线上 bug 修复成本高

最优解：Spring EL 表达式实现动态规则

无需 Drools、QLExpress 重型规则引擎，基于 Spring 原生 Spring EL 表达式，支持同时传入User、Coupon、Order多个业务对象，规则存入数据库，运行时动态解析判断优惠券是否可用，改规则只改数据库，服务无需重启、无需改代码，轻量、零依赖、适配 SpringBoot 项目。

二、Spring EL 多对象模式核心优势（优惠券场景）

Spring Expression Language（Spring 表达式语言），Spring 原生内置，无需引入第三方依赖：

原生支持 Spring 全家桶，无额外 jar 包、无版本冲突
支持同时传入User/Coupon/Order多个业务对象，直接对象.属性取值，表达式语义贴合业务
支持数值比较、逻辑运算、集合匹配、时间区间、空安全运算符
规则持久化 MySQL，支持热更新、动态生效
性能足够支撑优惠券高并发下单校验，缓存表达式后性能大幅提升
语法简单，运营可快速编写基础规则

三、优惠券规则数据库表设计

优惠券主表简化设计

sql
CREATE TABLE coupon (
id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '优惠券ID',
coupon_name VARCHAR(64) NOT NULL COMMENT '优惠券名称',
coupon_type TINYINT NOT NULL COMMENT '1满减券 2折扣券',
rule_expression VARCHAR(1024) NOT NULL COMMENT 'SpEL可用校验表达式，返回布尔值，支持user/coupon/order多对象属性',
discount_amount DECIMAL(10,2) COMMENT '优惠金额',
valid_start_time DATETIME NOT NULL COMMENT '券生效时间',
valid_end_time DATETIME NOT NULL COMMENT '券失效时间',
status TINYINT DEFAULT 1 COMMENT '状态 1正常 0下架',
rule_desc VARCHAR(512) COMMENT '规则中文说明，便于运营查看',
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='优惠券表';

多对象场景示例规则表达式（直接存入数据库）

spel
-- 示例1：订单满199、会员3级以上、非黑名单、下单在券有效期、商品匹配类目
order.totalAmount >= 199 and user.level >= 3 and !user.isBlack and order.createTime between coupon.validStartTime and coupon.validEndTime and coupon.category in order.goodsCategories

-- 示例2：新用户专享满99券，券剩余次数>0
order.totalAmount >= 99 and user.isNewUser and coupon.maxUseCount > 0

-- 示例3：空安全写法，防止对象null空指针报错
user?.level >= 2 and order?.totalAmount >= 50

四、核心业务实体（多对象入参载体）

1. User.java 用户对象

java
import lombok.Data;

@Data
public class User {
private Long userId;
// 会员等级 1普通 2银卡 3金卡
private Integer level;
// 是否黑名单用户
private Boolean isBlack;
// 是否新用户
private Boolean isNewUser;
}

2. Coupon.java 优惠券对象

java
import lombok.Data;
import java.time.LocalDateTime;

@Data
public class Coupon {
private Long couponId;
// 优惠券限定商品类目
private String category;
// 券生效时间
private LocalDateTime validStartTime;
// 券失效时间
private LocalDateTime validEndTime;
// 最大可使用次数
private Integer maxUseCount;
}

3. Order.java 订单对象

java
import lombok.Data;
import java.math.BigDecimal;
import java.time.LocalDateTime;
import java.util.List;

@Data
public class Order {
// 订单实付总金额
private BigDecimal totalAmount;
// 订单内全部商品类目集合
private List<String> goodsCategories;
// 下单时间
private LocalDateTime createTime;
}

五、Spring EL 全局配置类

java
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.expression.ExpressionParser;
import org.springframework.expression.spel.standard.SpelExpressionParser;

/**
* Spring EL 规则引擎全局配置
*/
@Configuration
public class SpelConfig {

/**
* 全局表达式解析器，单例复用
*/
@Bean
public ExpressionParser expressionParser() {
return new SpelExpressionParser();
}
}

六、通用多对象优惠券规则校验工具类

支持同时传入User、Coupon、Order三个对象，绑定独立变量名，内置异常捕获、空安全兼容，可直接用于下单校验、领券资格校验。

java
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.expression.Expression;
import org.springframework.expression.ExpressionParser;
import org.springframework.expression.spel.support.StandardEvaluationContext;
import org.springframework.stereotype.Component;

/**
* 基于Spring EL 多对象模式优惠券规则校验工具类
* 支持同时传入 user / coupon / order 三个业务对象，表达式直接读取对象属性
*/
@Slf4j
@Component
public class CouponSpelRuleUtil {

@Autowired
private ExpressionParser expressionParser;

/**
* 多对象入参统一校验方法
* @param ruleExpression 数据库存储SpEL规则表达式
* @param user 当前操作用户对象
* @param coupon 当前待校验优惠券对象
* @param order 当前下单订单对象
* @return true=优惠券可用 false=不满足规则不可用
*/
public boolean checkCouponAvailable(String ruleExpression, User user, Coupon coupon, Order order) {
// 无自定义规则，直接放行
if (ruleExpression == null || ruleExpression.trim().isEmpty()) {
return true;
}
try {
// 初始化表达式上下文
StandardEvaluationContext evalContext = new StandardEvaluationContext();
// 绑定多个业务对象，指定变量名，表达式中直接使用
evalContext.setVariable("user", user);
evalContext.setVariable("coupon", coupon);
evalContext.setVariable("order", order);

// 解析表达式并执行判断
Expression expression = expressionParser.parseExpression(ruleExpression);
Boolean result = expression.getValue(evalContext, Boolean.class);
// 空结果默认判定不可用
return Boolean.TRUE.equals(result);
} catch (Exception e) {
log.error("优惠券SpEL规则解析校验失败，表达式：{}，异常信息：{}", ruleExpression, e.getMessage(), e);
// 语法错误、对象为空、属性不存在等异常，统一返回不可用
return false;
}
}
}

七、业务服务层调用实战

1. 优惠券业务 Service

java
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Service;

@Slf4j
@Service
@RequiredArgsConstructor
public class CouponService {

private final CouponMapper couponMapper;
private final CouponSpelRuleUtil couponSpelRuleUtil;

/**
* 下单时校验优惠券是否可使用
* @param couponId 待使用优惠券ID
* @param userId 当前用户ID
* @param orderId 订单ID
* @return 校验结果+提示文案
*/
public ResultVO checkCouponUse(Long couponId, Long userId, Long orderId) {
// 1. 查询优惠券基础数据
Coupon coupon = couponMapper.selectById(couponId);
if (coupon == null || coupon.getStatus() == 0) {
return ResultVO.fail("优惠券不存在或已下架");
}
// 2. 查询用户、订单完整业务对象
User user = userMapper.selectById(userId);
Order order = orderMapper.selectById(orderId);
if (user == null || order == null) {
return ResultVO.fail("用户或订单信息异常");
}
// 3. Spring EL多对象动态校验规则
boolean available = couponSpelRuleUtil.checkCouponAvailable(coupon.getRuleExpression(), user, coupon, order);
if (available) {
return ResultVO.success("优惠券校验通过，可正常使用");
}
return ResultVO.fail("不满足优惠券使用条件，无法使用");
}
}

2. 单元测试验证多对象属性判断

java
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import java.math.BigDecimal;
import java.time.LocalDateTime;
import java.util.List;

@SpringBootTest
public class CouponSpelTest {

@Autowired
private CouponSpelRuleUtil couponSpelRuleUtil;

@Test
void testMultiObjectRuleCheck() {
// 1. 组装用户对象
User user = new User();
user.setLevel(3);
user.setIsBlack(false);
user.setIsNewUser(false);

// 2. 组装优惠券对象
Coupon coupon = new Coupon();
coupon.setCategory("FOOD");
coupon.setMaxUseCount(10);
coupon.setValidStartTime(LocalDateTime.of(2026, 6, 1, 0, 0));
coupon.setValidEndTime(LocalDateTime.of(2026, 6, 30, 23, 59));

// 3. 组装订单对象
Order order = new Order();
order.setTotalAmount(new BigDecimal("259"));
order.setGoodsCategories(List.of("FOOD", "DRINK"));
order.setCreateTime(LocalDateTime.of(2026, 6, 10, 14, 30));

// 4. 数据库存储的SpEL表达式
String ruleExpr = "order.totalAmount >= 199 and user.level >= 3 and !user.isBlack and order.createTime between coupon.validStartTime and coupon.validEndTime and coupon.category in order.goodsCategories";
boolean pass = couponSpelRuleUtil.checkCouponAvailable(ruleExpr, user, coupon, order);
System.out.println("优惠券是否可用：" + pass);
// 输出 true，校验通过
}
}

八、多对象模式常用 SpEL 语法合集

1. 对象基础属性比较

spel
// 订单金额门槛
order.totalAmount >= 99
// 用户会员等级限制
user.level >= 2
// 黑名单拦截
!user.isBlack
// 优惠券剩余可用次数
coupon.maxUseCount > 0

2. 空安全运算符（避免空指针）

spel
// user为null时直接返回false，不会抛出NPE
user?.level >= 3
order?.totalAmount >= 50

3. 集合包含判断（类目匹配）

spel
// 优惠券限定类目在订单商品类目列表中
coupon.category in order.goodsCategories

4. 时间区间判断

spel
// 下单时间落在优惠券有效期内
order.createTime between coupon.validStartTime and coupon.validEndTime

5. 复杂复合规则

spel
order.totalAmount >= 299
and user.level >= 2
and !user.isBlack
and coupon.maxUseCount > 0
and order.createTime between coupon.validStartTime and coupon.validEndTime
and coupon.category in order.goodsCategories

九、方案优缺点分析

✅ 优点

业务语义清晰：直接传入User/Coupon/Order领域对象，表达式对象.属性贴合业务，可读性远高于单一体封装参数
轻量化无依赖：Spring 原生能力，无需引入第三方规则引擎
规则完全解耦：规则存储数据库，运营修改规则无需改代码、重启服务
扩展性强：后续新增Shop、Member等对象，仅需新增setVariable绑定，工具类无需大幅改造
适配分层架构：符合项目原有 DO/VO 分层，无需额外封装统一上下文 DTO

❌ 缺点 & 生产优化方案

表达式存在执行安全风险
风险：恶意表达式可调用对象setter、反射方法篡改数据
优化：自定义SpelParserConfiguration，限制表达式仅允许读取 getter，屏蔽修改类方法、反射、静态类执行
重复解析表达式损耗性能
优化：增加本地缓存，key 为表达式字符串，缓存解析后的Expression对象，避免重复解析字符串
复杂长表达式可读性差
优化：数据库增加rule_desc字段，存储中文规则描述，后台配置页面同时展示表达式 + 说明

十、高阶生产优化补充

1. 表达式本地缓存（高并发下单优化）

使用Caffeine缓存解析完成的Expression，大幅降低下单接口 CPU 消耗，避免重复解析字符串表达式。

2. 自定义安全解析器（线上必备）

重写 SpEL 解析器，禁止表达式调用set、delete、反射、系统静态方法，仅开放属性读取能力，防止注入攻击。

3. 支持工具类静态方法拓展

可绑定自定义工具静态类，在表达式中调用工具方法，拓展复杂判断能力：

spel
// 表达式调用自定义工具类判断是否叠加券
T(com.market.util.CouponUtil).canStackCoupon(coupon.couponId) and order.totalAmount >= 99

十一、总结