> For the complete documentation index, see [llms.txt](https://helps.ptengine.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helps.ptengine.com/cn/faq/others/heatmap-save-blocked.md).

# 历史热力图 / 截图保存失败

本文说明「历史热力图保存」「热力图截图」「实验缩略图」等功能保存失败、或时好时坏的一个常见原因——我们后台打开你的页面时被页面的安全防护拦截，以及对应的解决办法。

## 为什么会失败

这些功能都需要我们在后台用浏览器打开你的页面，做快照 / 截图。如果你的站点启用了 WAF、反爬虫、或访问频率限制（HTTP 429），我们的访问可能被当作机器人拦下，导致保存失败。

解决办法取决于**这层防护是你自己能配置的、还是所在平台统一管理的**——下面两种情况按你的实际情况看其一即可。

## 情况一：你自有的站点 / 自己的 WAF / CDN —— 把我们加入白名单

如果页面是你自建的、或防护跑在你自己的 Cloudflare / 阿里云 / Akamai 等账户下，把我们的固定出口 IP 加入白名单即可解决：

* **按 IP 放行**：允许来自我们固定出口 IP 的访问。具体的固定出口 IP 请**联系我们获取**。

各主流防护的配置入口：

* **Cloudflare**：WAF → 自定义规则 / IP Access Rules，添加「允许（Allow）」规则。
* **阿里云 WAF**：网站防护 → 白名单，添加放行规则。
* **Akamai**：在对应的 Network List / ACL 中加入放行。

## 情况二：你的店铺在 Shopify / BASE / STORES / 楽天 / Yahoo 等平台上

如果你的页面跑在 **Shopify、BASE、STORES、楽天市場、Yahoo!ショッピング** 等平台上，页面的**限速（429）与 WAF / 反爬防护由平台统一管理**、走平台自己的 CDN。商家后台**无法为我们的抓取放行**——既不能放行我们的来源 IP，也无法绕过这层限速 / 拦截。上面「情况一」不适用，这也不是你的配置问题。

对这种情况，你可以：

* 适当**调低抓取 / 保存频率、错峰**（减少短时间内的集中访问）；
* 或直接联系我们，由我们**手动为你保存**。

你**无需**在平台后台做任何安全配置。

## 配置后如何确认

* 等下一次定期保存自动执行，或在后台手动触发一次保存 / 截图。
* 若仍然失败，请联系客服并附上页面 URL，我们会进一步排查。