架构与系统设计 / 系统课时
通道模拟服务
通道模拟服务
本课将搭建一个本地可运行的支付通道模拟服务,通过请求参数精确控制成功、失败、响应超时和重复通知。完成后,你可以不依赖真实渠道,在开发与测试环境中稳定复现边界条件并验证平台的幂等和补偿逻辑。
学习目标
- 设计可重复、可观测的通道模拟接口
- 使用一个服务覆盖同步成功、同步失败、超时和重复通知
- 运行模拟服务并验证不同模式下的平台表现
明确模拟服务的最小能力
一个有价值的模拟服务不只是返回固定 JSON,而是要能控制渠道行为。最小能力包括:根据模式返回成功或失败、延迟响应制造读取超时、向指定回调地址发送通知,以及按相同交易号重复发送通知。
模拟服务还应保证输入可追踪。每次请求至少携带 orderNo,响应中原样返回该值;日志中记录模式、延迟时间和通知次数。这样测试失败时可以快速确认问题发生在平台、网络还是模拟端。

约定接口和行为模式
本课使用一个 POST /pay 接口,通过查询参数 mode 控制行为,请求体只包含订单号和通知地址。四种模式的约定如下:
| 模式 | 同步行为 | 异步行为 |
|---|---|---|
success |
立即返回成功 | 不发送通知 |
fail |
立即返回失败 | 不发送通知 |
timeout |
延迟 8 秒后返回成功 | 不发送通知 |
duplicate_notify |
立即返回处理中 | 连续发送两次相同成功通知 |
真实平台的读取超时应配置为小于 8 秒,才能稳定触发 timeout 场景。重复通知模式使用相同的 orderNo 和状态,目的是验证回调处理是否幂等,而不是模拟两笔不同交易。
实现可运行的模拟服务
下面的 Python 3 示例只依赖标准库。保存为 channel_simulator.py 后即可运行。为保证示例安全,通知地址仅用于本地测试环境,不应暴露到公网。
import json
import time
import urllib.request
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
from urllib.parse import parse_qs, urlparse
HOST = "127.0.0.1"
PORT = 8089
def post_json(url: str, payload: dict) -> None:
data = json.dumps(payload).encode("utf-8")
request = urllib.request.Request(
url,
data=data,
headers={"Content-Type": "application/json"},
method="POST",
)
with urllib.request.urlopen(request, timeout=3) as response:
response.read()
class ChannelHandler(BaseHTTPRequestHandler):
def write_json(self, status_code: int, payload: dict) -> None:
body = json.dumps(payload, ensure_ascii=False).encode("utf-8")
self.send_response(status_code)
self.send_header("Content-Type", "application/json; charset=utf-8")
self.send_header("Content-Length", str(len(body)))
self.end_headers()
self.wfile.write(body)
def do_POST(self) -> None:
parsed = urlparse(self.path)
if parsed.path != "/pay":
self.write_json(404, {"message": "not found"})
return
content_length = int(self.headers.get("Content-Length", "0"))
payload = json.loads(self.rfile.read(content_length) or b"{}")
mode = parse_qs(parsed.query).get("mode", ["success"])[0]
order_no = payload.get("orderNo", "")
notify_url = payload.get("notifyUrl", "")
if mode == "fail":
self.write_json(200, {"orderNo": order_no, "status": "FAIL"})
return
if mode == "timeout":
# 延迟时间应大于被测平台的读取超时
time.sleep(8)
self.write_json(200, {"orderNo": order_no, "status": "SUCCESS"})
return
if mode == "duplicate_notify":
self.write_json(200, {"orderNo": order_no, "status": "PROCESSING"})
if notify_url:
notice = {"orderNo": order_no, "status": "SUCCESS"}
for _ in range(2):
post_json(notify_url, notice)
return
self.write_json(200, {"orderNo": order_no, "status": "SUCCESS"})
def log_message(self, format: str, *args) -> None:
print("%s - %s" % (self.address_string(), format % args))
if __name__ == "__main__":
server = ThreadingHTTPServer((HOST, PORT), ChannelHandler)
print(f"channel simulator listening on http://{HOST}:{PORT}")
server.serve_forever()预期结果:程序启动后持续监听本机 8089 端口,不会自动退出。
channel simulator listening on http://127.0.0.1:8089发送请求并观察结果
先启动服务,再在另一个终端发送成功请求。动态端口可替换为实际值,本例固定使用 8089。
curl -s -X POST "http://127.0.0.1:8089/pay?mode=success" -H "Content-Type: application/json" -d '{"orderNo":"ORDER-1001","notifyUrl":""}'预期输出:
{"orderNo": "ORDER-1001", "status": "SUCCESS"}测试失败模式时,把 mode 改为 fail;测试超时时,把平台读取超时配置为小于 8 秒并使用 mode=timeout;测试重复通知时,需要先准备一个本地回调地址,再把它填入 notifyUrl。
用场景矩阵完成验收
模拟环境的验收重点不是“服务能返回”,而是平台能否在不同输入下保持正确状态。建议至少覆盖以下检查:
success:订单直接变为成功,只生成一次交易流水。fail:订单进入失败,不触发主动查询。timeout:平台先进入未知态,随后通过查询或补偿收敛。duplicate_notify:两次相同通知只产生一次状态变更和一次业务副作用。- 使用同一
orderNo重放请求:平台不得创建第二笔渠道交易。
为了让自动化测试稳定,模式、延迟和通知次数都应由参数明确控制,避免依赖随机概率。随机故障适合压力测试,不适合作为日常回归测试的唯一手段。