写一个 Mock API Server 让生活更简单

公司项目的业务逻辑蛮复杂的，有时候我们需要测试 UI，就得让订单达到某一个特定的状态，往往需要在后台里先点个几分钟。其实最后我们还不是拿的后端返回的数据来填充 UI，所以为什么不直接把这个状态的数据构造好，直接拿来使用呢？所以我还是决定写个 Mock Server。

Mock Server 的功能很简单：

根据 API Endpoint，返回配置文件中指定的 JSON 文件；
可以局部匹配参数，返回指定的 JSON 文件。

后来 Android 端的小伙伴似乎也有点兴趣，但不想总是改代码指向 Mock Server，那行，我们就再加一个功能：3. 配置文件中没有指定的接口的请求，转发到开发服务器中。

前两部分很简单，就是写一个 API Server 而已。因为懒得碰其它语言，直接使用了 Swift + Vapor。每次收到请求，我们都读取一下配置文件，大概是这么个结构：

struct Pref: Decodable {
    let endpoints: [Endpoint]
}

struct Endpoint: Decodable {
    let endpoint: String
    let filename: String?
	
    let dispatch: [Dispatcher]?
	
    struct Dispatcher: Decodable {
        let parameters: JSONValue
        let filename: String
		
        func match(_ param: JSONValue) -> Bool {
            return parameters.compare(param)
        }
    }
}

获得请求后，我们首先判断接口是否在 Pref.endpoints 中，如果有，则在看其参数是否存在一个子集处于 Endpoint.dispatch 中，如果有则使用其中的 filename.json，没有则 Fallback 到 Endpoint.filename.json。

对于其它的一切情况，返回 404。

第三点就比较麻烦了，一开始我想在 Mock Server 里再发一次请求，尽管咨询了后端的同学，但最终还是遇到了一些我暂时解决不了的问题：

多个请求同时来的时候会收不到一些响应；
用 Nginx 实现 HTTPS 的时候，响应会变成双倍。但 Vapor 3 直接实现 HTTPS，找遍了 Google 都没找到方法。

我倒腾了很久都没搞懂是什么情况……最后 Google 发现 Nginx 有一个东西叫做 proxy_next_upstream，我们可以指定多个 Upstream，如果一个有问题，就用下一个。所以我们可以写下这样的 Upstream：

upstream w {
    server localhost:4343 max_fails=0 weight=200;
    server real.dev.api.server.com:443 max_fails=0 weight=1;
}

值得注意的是要写下权重，避免 Nginx 轮询调用。

然后再写两个 Server：

server { #A
    listen       80;
    listen       443 ssl;
    server_name  real.dev.api.server.com;

    ssl_certificate servernew.crt;
    ssl_certificate_key server.key;

    ssl_session_cache    shared:SSL:1m;
    ssl_session_timeout  5m;

    location / {
        proxy_pass https://w;
        proxy_set_header Host real.dev.api.server.com;
        proxy_next_upstream error timeout http_500 http_502 http_503 http_504 http_404 invalid_header non_idempotent;
	}
}

server { #B
    listen       4343 ssl;
    server_name  localhost;

    ssl_certificate servernew.crt;
    ssl_certificate_key server.key;

    location / {
        proxy_pass http://localhost:9090;
        proxy_set_header Host real.dev.api.server.com;
    }
}

如此一来，通过改 Host 或改代码指向本机 IP 的方式，我们就能通过 Server#A 先调用 Mock Server，如果配置文件中没有请求的接口，则返回 404，接着调用真实的开发环境接口。

Server#B 是因为 Server#A 的 proxy_pass 用的是 https，试了一下有问题，所以又做了一层。我并不清楚以上哪一行是多余的，反正能用（

现在我们就能无痛使用 Mock Server 获得假数据了。