架构与系统设计 / 系统课时
候选通道筛选
候选通道筛选
本课实现支付路由的第一步:从全部通道中筛出真正可参与本次交易的候选集合。你将把商户权限、币种、地区、金额区间和支付产品转化为可验证的硬性过滤规则。
学习目标
- 明确候选通道筛选的输入、顺序和输出
- 使用确定性规则排除不满足条件的通道
- 编写可运行代码并验证多条件筛选结果
定义输入与过滤顺序
一次筛选至少需要商户编号、币种、地区、交易金额和产品类型。通道配置则需要包含启用状态、支持范围、金额上下限以及允许使用该通道的商户集合。
候选筛选只回答“能不能用”,不负责决定“优先用谁”。优先级、权重、费率或成功率应在候选集合形成后再参与排序,避免软指标绕过硬性限制。
推荐先检查启用状态和商户权限,再检查产品、币种、地区,最后比较金额。这样可以尽早缩小集合,也便于日志明确记录淘汰原因。
金额必须使用十进制类型,不能用 double。金额区间通常采用闭区间,即满足 minAmount <= amount <= maxAmount;若业务采用左闭右开区间,应在模型和测试中明确约定。

用 Java 完成候选筛选
下面示例使用 JDK 17,可直接保存为 CandidateChannelFilterDemo.java。示例中的商户白名单为空时表示对所有商户开放。
import java.math.BigDecimal;
import java.util.List;
import java.util.Set;
public class CandidateChannelFilterDemo {
record PaymentRequest(
String merchantNo,
String currency,
String region,
BigDecimal amount,
String productType
) {}
record ChannelConfig(
String channelCode,
boolean enabled,
Set<String> merchantWhitelist,
Set<String> currencies,
Set<String> regions,
Set<String> productTypes,
BigDecimal minAmount,
BigDecimal maxAmount
) {}
static List<ChannelConfig> filterCandidates(
PaymentRequest request,
List<ChannelConfig> channels
) {
return channels.stream()
// 先执行成本低且淘汰率高的硬条件。
.filter(ChannelConfig::enabled)
.filter(channel -> channel.merchantWhitelist().isEmpty()
|| channel.merchantWhitelist().contains(request.merchantNo()))
.filter(channel -> channel.productTypes().contains(request.productType()))
.filter(channel -> channel.currencies().contains(request.currency()))
.filter(channel -> channel.regions().contains(request.region()))
// BigDecimal.compareTo 忽略小数位差异,适合金额边界比较。
.filter(channel -> request.amount().compareTo(channel.minAmount()) >= 0)
.filter(channel -> request.amount().compareTo(channel.maxAmount()) <= 0)
.toList();
}
public static void main(String[] args) {
PaymentRequest request = new PaymentRequest(
"M1001", "HKD", "HK",
new BigDecimal("500.00"), "WALLET_PAYMENT"
);
List<ChannelConfig> channels = List.of(
new ChannelConfig(
"CHANNEL_A", true, Set.of("M1001"),
Set.of("HKD"), Set.of("HK"), Set.of("WALLET_PAYMENT"),
new BigDecimal("1.00"), new BigDecimal("1000.00")
),
new ChannelConfig(
"CHANNEL_B", true, Set.of(),
Set.of("USD"), Set.of("HK"), Set.of("WALLET_PAYMENT"),
new BigDecimal("1.00"), new BigDecimal("2000.00")
),
new ChannelConfig(
"CHANNEL_C", false, Set.of("M1001"),
Set.of("HKD"), Set.of("HK"), Set.of("WALLET_PAYMENT"),
new BigDecimal("1.00"), new BigDecimal("1000.00")
)
);
filterCandidates(request, channels)
.forEach(channel -> System.out.println(channel.channelCode()));
}
}预期输出:
CHANNEL_ACHANNEL_B 因币种不匹配被排除,CHANNEL_C 因未启用被排除。实际系统中还应为每个淘汰条件记录结构化原因,例如 CURRENCY_NOT_SUPPORTED,便于路由审计和故障定位。
空结果、配置与验收
候选集合为空时,应返回明确的“无可用通道”业务错误,并记录本次请求条件和各通道淘汰原因。不要自动忽略币种、地区或金额限制重试,因为这种降级可能把交易发送到不具备清算能力的通道。
通道配置变更后要考虑缓存一致性。可以为配置增加版本号,并让一次路由过程固定读取同一版本,避免筛选中途因刷新造成前后条件不一致。
验收时至少覆盖三个金额边界:等于最小值应通过,等于最大值应通过,超出任一边界应被排除。还要验证空白名单的开放语义,以及非空白名单只允许指定商户的限制。