架构与系统设计 / 系统课时
路由决策留痕
路由决策留痕
路由决策留痕要把一次选择过程保存成不可变快照,使开发、运营和审计人员能够回答“有哪些候选、为何被过滤、最终为何选中、当时如何计价”这四个关键问题。
学习目标
- 设计可复盘的路由决策快照
- 记录候选、过滤、选择和计价结果
- 通过请求号与链路号快速定位异常
留痕范围与处理流程
每次路由尝试都应生成一条独立记录,并用 requestId 与 attemptNo 标识。候选通道必须全部保留,不能只保存最终通道;被淘汰的候选要记录稳定的原因码,例如 CHANNEL_DISABLED、CURRENCY_NOT_SUPPORTED、AMOUNT_OUT_OF_RANGE 或 QUOTA_EXCEEDED。
最终快照至少包含策略版本、候选列表、过滤结果、评分结果、最终通道、商户手续费、通道成本、毛利和链路追踪号。这样即使后续规则已修改,也能按当时版本解释历史决策。

数据表设计
下面示例使用 MySQL 8.0。结构化检索字段单独建列,候选明细和计价明细放入 JSON,既便于查询关键索引,也能完整保留当时的决策上下文。
CREATE TABLE route_decision_audit (
audit_id BIGINT NOT NULL,
request_id VARCHAR(64) NOT NULL,
attempt_no INT NOT NULL,
merchant_no VARCHAR(32) NOT NULL,
merchant_order_no VARCHAR(64) NOT NULL,
amount DECIMAL(20, 2) NOT NULL,
currency CHAR(3) NOT NULL,
strategy_version VARCHAR(32) NOT NULL,
candidates_json JSON NOT NULL,
selected_channel VARCHAR(32) NULL,
pricing_json JSON NULL,
decision_status VARCHAR(16) NOT NULL,
trace_id VARCHAR(64) NOT NULL,
created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
PRIMARY KEY (audit_id),
UNIQUE KEY uk_request_attempt (request_id, attempt_no),
KEY idx_merchant_order (merchant_no, merchant_order_no),
KEY idx_trace_id (trace_id),
KEY idx_created_at (created_at)
);
INSERT INTO route_decision_audit (
audit_id, request_id, attempt_no, merchant_no,
merchant_order_no, amount, currency, strategy_version,
candidates_json, selected_channel, pricing_json,
decision_status, trace_id
) VALUES (
1001, '<REQUEST_ID>', 1, 'M10001',
'<ORDER_NO>', 1000.00, 'CNY', 'route-v12',
JSON_ARRAY(
JSON_OBJECT(
'channelCode', 'CH_A',
'eligible', TRUE,
'score', 92,
'filterReason', NULL
),
JSON_OBJECT(
'channelCode', 'CH_B',
'eligible', FALSE,
'score', NULL,
'filterReason', 'CURRENCY_NOT_SUPPORTED'
)
),
'CH_A',
JSON_OBJECT(
'merchantFee', 6.00,
'channelCost', 4.50,
'grossProfit', 1.50,
'currency', 'CNY'
),
'SELECTED',
'<TRACE_ID>'
);
SELECT
audit_id,
request_id,
selected_channel,
decision_status,
CAST(
JSON_UNQUOTE(
JSON_EXTRACT(pricing_json, '$.merchantFee')
) AS DECIMAL(20, 2)
) AS merchant_fee
FROM route_decision_audit
WHERE request_id = '<REQUEST_ID>'
AND attempt_no = 1;预期结果
+----------+--------------+------------------+-----------------+--------------+
| audit_id | request_id | selected_channel | decision_status | merchant_fee |
+----------+--------------+------------------+-----------------+--------------+
| 1001 | <REQUEST_ID> | CH_A | SELECTED | 6.00 |
+----------+--------------+------------------+-----------------+--------------+<REQUEST_ID>、<ORDER_NO> 和 <TRACE_ID> 应替换为实际值。无可用通道时,selected_channel 与 pricing_json 可以为空,但 candidates_json 和 decision_status 仍必须记录,状态可使用 NO_ROUTE。
写入时机与一致性
审计快照应在候选过滤、评分和计价全部完成后一次性写入,避免先写候选、后补结果造成半条记录。订单已经保存最终通道时,核心审计记录应与订单路由结果处于同一本地事务,保证二者要么同时成功,要么同时回滚。
通道调用失败后重新路由时,不要覆盖第一次记录,而是递增 attemptNo 新增一条快照。这样可以区分“首次选择错误”和“通道调用失败后切换”,也能按时间还原完整尝试链路。
大体积调试日志可以异步写入,但决定支付去向和费用的核心字段不应依赖可能丢失的普通应用日志。原因码应使用稳定枚举,详细信息另设文本字段,避免运营报表被自由文本拆散。
排障查询顺序
先通过商户订单号找到对应 requestId,再按 attemptNo 查看每次路由尝试。随后依次核对策略版本、候选数量、过滤原因、评分排序、最终通道和计价结果。如果最终通道不在候选集、过滤后仍被选中,或毛利与费率规则不一致,就说明快照写入或路由实现存在逻辑缺陷。
验收时至少覆盖正常选中、全部过滤、首通道失败后重试和计价异常四种场景。每种场景都应能仅凭审计记录还原决策,不依赖当时的内存对象或临时日志。