# The Graph旧端点失效：核BNB/Polygon发布状态、Gateway与权限

整理：链小知（AI 辅助）
资料核对日期：2026-10-14
引用地址：https://lianxiaozhi.com/tools/guides/the-graph-staging-network-endpoint-migration-check
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

用已有子图记录区分Studio部署、Network发布、Indexer同步和Gateway认证，排查staging迁移影响。

## 使用工具
- [The Graph](https://lianxiaozhi.com/tools/the-graph) · [官方入口](https://thegraph.com/)

## 前置条件
- 准备已有脱敏配置、错误或回执记录，保留网络、对象身份、版本及时间；缺项标待核。
- 仅阅读公开文档和已有记录，不登录、安装、调用RPC/API、获取报价、签名、部署、转账或重试业务。

## 1. 确认受影响的是staging查询

官方9月24日安排在2026年10月8日结束BNB Smart Chain和Polygon的Studio staging查询；其他网络后续安排不能自行补日期。Studio仍用于版本、发布、付款和API key管理，并非整个Studio关闭。

已有Network发布并通过Network查询的子图不因这一安排需要重发。先按原端点区分Studio staging或Gateway，保留原网络与失效时间，日历过了不等于已验证全网切换成功。

核对结果：受影响网络、端点类型和实际故障记录分列。
依据：[The Graph：BNB/Polygon staging迁移安排](https://thegraph.com/blog/subgraph-studio-traffic-to-network/)

## 2. 区分部署、发布和正在服务的版本

部署到Studio供测试与发布到Network是不同阶段。发布让Curator/Indexer能够开始发现和同步，不自动证明目标部署已索引至应用所需区块。

核原Subgraph ID、具体部署/版本、发布记录及Explorer已有状态。文档说更新metadata不会创建新部署版本；不能把标题更新当索引修复。本教程不发布、连接钱包或支付curation。

核对结果：Studio部署、Network发布、metadata与实际部署版本分别有记录。
依据：[The Graph：发布至Network、版本与索引](https://thegraph.com/docs/en/subgraphs/developing/deploying-publishing/publishing-a-subgraph/)
依据：[The Graph：BNB/Polygon staging迁移安排](https://thegraph.com/blog/subgraph-studio-traffic-to-network/)

## 3. 对照Gateway身份与有效密钥

官方Gateway格式含API key及Subgraph ID，也支持Bearer方式。仅核已有脱敏端点结构和密钥关联；完整URL可能暴露密钥，不写入共享日志或截图。

密钥重新生成会立即使旧key失效。根据已有状态确认是不是端点已换而应用仍引用旧key，不为排查重新生成或尝试请求。

核对结果：正确Subgraph ID、端点种类与原key状态可追溯，凭据已脱敏。
依据：[The Graph：Gateway端点、密钥权限与消费限额](https://thegraph.com/docs/en/subgraphs/providers/subgraph-studio/managing-api-keys/)

## 4. 把付款和权限条件与索引同步分开

迁移安排要求配置billing与API key。原key记录可核按日历月的可选USD消费限额、授权域名和允许子图列表；额度或权限缺项不能当成子图没数据。

Foundation声明会为符合范围的新发布子图使用自动curation bot，但这不保证每个部署在某个时点已有Indexer同步。发布材料对奖励资格和curation还有条件；不把通用旧Upgrade Indexer表述当所有迁移实例服务保证。

核对结果：billing/key权限、Network发布与Indexer服务/区块进度各自有证据或待核。
依据：[The Graph：BNB/Polygon staging迁移安排](https://thegraph.com/blog/subgraph-studio-traffic-to-network/)
依据：[The Graph：Gateway端点、密钥权限与消费限额](https://thegraph.com/docs/en/subgraphs/providers/subgraph-studio/managing-api-keys/)
依据：[The Graph：发布至Network、版本与索引](https://thegraph.com/docs/en/subgraphs/developing/deploying-publishing/publishing-a-subgraph/)

## 5. 按已有响应和版本判断恢复

将原失败分类为旧staging端点、无Network发布、key失效/权限或消费条件、Indexer同步不足；没有原错误及状态时保持原因未知。

恢复应对应正确Network部署、授权端点与已有成功响应，并再核应用所需区块/实体是否满足；官方迁移目标是连续服务，不等于个人应用已被本教程验证恢复。

核对结果：能指出缺失环节，未用发布成功或域名可打开代替查询恢复。
依据：[The Graph：BNB/Polygon staging迁移安排](https://thegraph.com/blog/subgraph-studio-traffic-to-network/)
依据：[The Graph：发布至Network、版本与索引](https://thegraph.com/docs/en/subgraphs/developing/deploying-publishing/publishing-a-subgraph/)
依据：[The Graph：Gateway端点、密钥权限与消费限额](https://thegraph.com/docs/en/subgraphs/providers/subgraph-studio/managing-api-keys/)

## 常见错误
- 协议发布所在Arbitrum网络与所索引BNB/Polygon资产网络不同，不能只按发布链判断数据来源。
- 本教程处理端点迁移；实体schema、区块新鲜度和分页仍需按原查询范围核。

## 完成检查
- 形成条件、费用、执行阶段与未证实项的核对记录。
- 本教程仅documentation；未验收实际配置、服务可用性或资金交付。

## 相关知识
- [原始、解码和整理后的链上数据有什么区别？](https://lianxiaozhi.com/learn/raw-decoded-curated-data)
- [链上指标历史数值为什么会变？](https://lianxiaozhi.com/learn/point-in-time-metrics)

## 官方依据
- [The Graph：BNB/Polygon staging迁移安排](https://thegraph.com/blog/subgraph-studio-traffic-to-network/)
- [The Graph：发布至Network、版本与索引](https://thegraph.com/docs/en/subgraphs/developing/deploying-publishing/publishing-a-subgraph/)
- [The Graph：Gateway端点、密钥权限与消费限额](https://thegraph.com/docs/en/subgraphs/providers/subgraph-studio/managing-api-keys/)