魔方财务对接产品购物车不显示修复办法

购物车转圈排查记录：先看汇率接口，再考虑本机承接

这段时间又碰到一例，整理成排查记录，供做魔方财务对接的同行参考。

客户反馈的现象比较典型：后台商品列表能正常看，点进商品购物车页面一直转圈，偶尔直接打不开；换浏览器、清缓存也试过，表现不稳定。翻日志能看到请求 api.exchangerate-api.com 超时。

从去年到现在，这类魔方财务对接产品的工单遇到过几次，触发点多半集中在服务器出网策略调整、DNS 解析异常，或者汇率接口响应慢。现场排查时，先把报错日志和请求时间点对齐，再看接口返回情况，效率会高一些。

购物车转圈、打不开，先看货币汇率接口有没有按时返回。

魔方财务对接产品里，商品购物车页面会依赖货币同步接口；接口定期去获取货币汇率，拿不到时页面就可能打不开，或者加载很慢。接口域名是：

api.exchangerate-api.com

如果服务器确实获取不到，建议先确认影响范围：是单个产品还是全部商品购物车、是否高峰期更明显、服务器能不能正常访问外网。请保留报错日志和请求时间点，再按下面的方式处理。

服务器出网受限时，可以把汇率接口在本机“接住”，让购物车先稳定下来。

排查和操作可以这样走：

1. 在服务器上确认能否访问 api.exchangerate-api.com。如果出现超时、证书错误或 DNS 异常，再考虑本地承接方案。
2. 上传本文文件，按业务使用的货币代码准备对应 JSON 文件，例如 USD.json，放到网站根目录。
3. 在宝塔新建一个网站，域名填 api.exchangerate-api.com，伪静态和 SSL 按站点实际情况配置好。
4. 修改 /etc/hosts，加入：

127.0.0.1 api.exchangerate-api.com

5. 伪静态设置：

rewrite ^/v4/latest/([A-Z][A-Z][A-Z])/?$ /$1.json last;

这条规则的作用是把 /v4/latest/USD 这类请求映射到本地的 /USD.json。请按实际货币代码准备文件，避免只放一个文件导致其他币种请求失败。

6. 保存后重载 Nginx，用 curl 验证接口返回，再回魔方财务商品购物车页面复测。

操作前请备份站点配置和 /etc/hosts，改完用 curl 和购物车页面各验证一次。

建议在维护窗口操作，改动范围控制清楚，回滚路径也提前留好。

若服务器本身可以正常出网，不建议长期依赖本地映射。

请按业务需要定期同步汇率文件，并观察购物车页面的实际响应。以上处理方式供同行按现场情况取用。