架构与系统设计 / 系统课时

候选通道筛选

候选通道筛选

本课实现支付路由的第一步:从全部通道中筛出真正可参与本次交易的候选集合。你将把商户权限、币种、地区、金额区间和支付产品转化为可验证的硬性过滤规则。

学习目标

  • 明确候选通道筛选的输入、顺序和输出
  • 使用确定性规则排除不满足条件的通道
  • 编写可运行代码并验证多条件筛选结果

定义输入与过滤顺序

一次筛选至少需要商户编号、币种、地区、交易金额和产品类型。通道配置则需要包含启用状态、支持范围、金额上下限以及允许使用该通道的商户集合。

候选筛选只回答“能不能用”,不负责决定“优先用谁”。优先级、权重、费率或成功率应在候选集合形成后再参与排序,避免软指标绕过硬性限制。

推荐先检查启用状态和商户权限,再检查产品、币种、地区,最后比较金额。这样可以尽早缩小集合,也便于日志明确记录淘汰原因。

金额必须使用十进制类型,不能用 double。金额区间通常采用闭区间,即满足 minAmount <= amount <= maxAmount;若业务采用左闭右开区间,应在模型和测试中明确约定。

候选通道逐层筛选流程

用 Java 完成候选筛选

下面示例使用 JDK 17,可直接保存为 CandidateChannelFilterDemo.java。示例中的商户白名单为空时表示对所有商户开放。

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()));
    }
}

预期输出:

text
CHANNEL_A

CHANNEL_B 因币种不匹配被排除,CHANNEL_C 因未启用被排除。实际系统中还应为每个淘汰条件记录结构化原因,例如 CURRENCY_NOT_SUPPORTED,便于路由审计和故障定位。

空结果、配置与验收

候选集合为空时,应返回明确的“无可用通道”业务错误,并记录本次请求条件和各通道淘汰原因。不要自动忽略币种、地区或金额限制重试,因为这种降级可能把交易发送到不具备清算能力的通道。

通道配置变更后要考虑缓存一致性。可以为配置增加版本号,并让一次路由过程固定读取同一版本,避免筛选中途因刷新造成前后条件不一致。

验收时至少覆盖三个金额边界:等于最小值应通过,等于最大值应通过,超出任一边界应被排除。还要验证空白名单的开放语义,以及非空白名单只允许指定商户的限制。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

候选通道筛选

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通