BSC 测试网：链设置、水龙头和 RPC 端点设置

BSC 测试网链设置一览

这些是将 BSC 测试网添加到钱包或指向客户端所需的值。链 ID 97 是实际区分此网络与 BNB Smart Chain 主网（链 ID 56）的字段，因此请在每个配置文件和钱包界面中验证它。

如果工具要求网络名称，“BNB Smart Chain 测试网”和“BSC 测试网”在实践中都被接受；名称是装饰性的，链 ID 不是。

将 BSC 测试网添加到 MetaMask 而不破坏主网

最常见的钱包错误是编辑现有的 BNB Smart Chain 主网条目，而不是添加新网络。将 BSC 测试网添加为单独的网络，以便主网保持完整，并且你的钱包清楚地显示你所在的链。

在 MetaMask 中，打开网络选择器，选择“添加网络”，然后选择“手动添加网络”，并填写上表中的链设置。保存，切换到新网络，并确认网络详情中的链 ID 显示为 97。如果你使用不同的钱包，字段名称可能不同，但值相同。

• 不要覆盖主网 BNB Smart Chain 条目——而是添加新网络。
• 保存后，切换网络并重新检查链 ID；一些钱包会缓存之前的链。
• 如果钱包显示 0 tBNB 余额，这是预期的，直到你从水龙头领取。
• 为测试网工作保留一个单独的账户，以便测试交易永远不会与主网历史混合。

从水龙头获取 tBNB

BSC 测试网 gas 用 tBNB 支付，你可以从官方 BNB Chain 测试网水龙头获取。水龙头有速率限制，可能需要少量主网 BNB 余额或钱包连接以防止滥用，因此请在 CI 运行之前而不是期间计划水龙头领取。

tBNB 没有实际价值。不要购买它，不要将真实资产桥接到测试网期望恢复它们，也不要将测试网余额视为生产数据。如果你需要更大数量进行负载测试，请通过水龙头的文档渠道请求，而不是编写重复领取的脚本。

• 将 tBNB 领取到你的部署脚本使用的同一地址。
• 首先为部署者账户提供资金；没有 gas 合约调用会失败。
• 水龙头限制按计划重置——查看水龙头页面了解当前规则。
• 保留少量 tBNB 缓冲，用于失败交易的 gas 和 nonce 重试。

将 Hardhat、Foundry、viem 或 ethers 指向 BSC 测试网 RPC

钱包设置完成后，下一步是将你的工具连接到 JSON-RPC 端点。模式在各框架中相同：将 RPC URL 存储在环境变量中，显式设置链 ID 97，并保留单独的主网配置，以便复制粘贴错误时大声失败，而不是静默部署到主网。

下面的代码片段使用 RPC URL 的占位符。将它们替换为你的提供商的端点——对于 OnFinality，当前的 BSC 测试网端点列在 BNB 测试网网络页面 上。

• Hardhat：添加一个 bscTestnet 网络条目，包含 url 和 chainId: 97。
• Foundry：在 foundry.toml 中设置 [rpc_endpoints] bsc_testnet = "${BSC_TESTNET_RPC_URL}"。
• viem：创建一个链对象，id: 97，并传递传输 URL。
• ethers：使用 new JsonRpcProvider(url, 97)，以便在连接时断言链 ID。

调试路径：当 BSC 测试网请求失败时

测试网故障通常归结为少数几种原因。按顺序处理它们——大多数在第一步或第二步解决，顺序可以避免你在真正问题是空钱包时追逐端点问题。

首先确认端点报告的链 ID，然后确认发送者有 tBNB，然后查看交易本身。如果链上一切看起来正确但调用仍然失败，端点是下一个怀疑对象。

当公共端点不够时

公共 BSC 测试网端点对于单个开发者点击 dApp 来说没问题。当多个 CI 作业、暂存前端和索引器都共享同一个被节流的 URL 时，它们就成了问题。症状看起来像不稳定的测试和间歇性超时，而不是干净的错​​误，这使得调试成本高昂。

托管 RPC 端点为你提供一个具有可预测限制的 URL，并在出现问题时提供支持路径。专用节点更进一步：为归档查询、日志密集型调试和共享端点可能无法可靠支持的 WebSocket 订阅提供隔离容量。OnFinality 提供两者——从 BNB 测试网网络页面 开始获取端点详情，并查看 支持的 RPC 网络 获取完整列表。

• 单个开发者，偶尔部署：公共端点通常足够。
• 团队 CI 与并行作业：托管端点避免共享节流。
• 归档读取、跟踪调用或大量 eth_getLogs：在提交之前检查方法支持。
• 长期 WebSocket 订阅：确认所选套餐的传输支持。

测试网到主网的准备清单

BSC 测试网紧密镜像主网，但通过的测试网运行并不是主网准备就绪的证明。在推广合约或服务之前，检查以下项目——每一项都能捕获一类仅靠测试网无法暴露的 bug。

目标不是重新测试所有内容，而是确认链 ID 97 和链 ID 56 之间的差异在你的配置、gas 假设和监控中得到明确处理。

• 链 ID 从配置读取，而不是硬编码在一个容易遗漏的地方。
• Gas 估算和优先费用在主网上重新测量；测试网条件不同。
• 合约地址是环境特定的，不在测试网和主网之间共享。
• 浏览器链接和监控仪表板指向正确的网络。
• 依赖水龙头的脚本在生产部署之前被移除或门控。
• RPC 端点和套餐的大小根据预期的主网流量而非测试网流量确定。

常见问题