SuperAPI AI 工具集

troubleshoot-connection

通用与其它

查看项目

更新于 10-16 00:29

技能介绍

用途:当连接请求挂起或报错、React Native 应用在导入或运行时崩溃、二维码不显示或深链未打开 MetaMask 移动端、Solana 钱包适配器检测不到 MetaMask、会话在刷新后丢失或断开异常时,可用此技能系统排查 MetaMask Connect 集成。

主要能力:提供症状→原因→修复的对照清单,涵盖:连接挂起(preferExtension 默认开启、并发 connect)、用户拒绝(4001)、待处理连接(-32002)、链未加入 supportedNetworks、React Native 的 Buffer/Event/CustomEvent 缺失、深链未配置 preferredOpenLink、Metro 无法解析 Node 内置模块、crypto.getRandomValues 缺失、Solana 适配器未检测到钱包、devnet/testnet 不可用、页面刷新后会话恢复、disconnect 作用域差异、二维码不显示或需强制移动端流程、CSP 阻止二维码弹窗、eth_coinbase 返回值不一致、wallet_switchEthereumChain 掩盖 4902、以及分析事件 _rejected/_failed 分类问题。

使用方式:按症状查阅对应条目并套用修复。例如注册 display_uri 监听器后再 connect();React Native 入口最先导入 'react-native-get-random-values' 并自补 Buffer、Event、CustomEvent;为 Metro 配置 extraNodeModules 空模块;Solana 侧始终传 wallets={[]};刷新后先用 getAccount() 检查缓存状态并订阅 provider 事件。必要命令保持原样,如 npm install @metamask/connect-multichain@^0.12.1 @metamask/multichain-ui@^0.4.1、npm install @metamask/connect-evm@^1.3.1。

适用场景:EVM 与 Solana dApp、React Native 移动端集成、浏览器扩展与移动端 MWP 传输选择、以及连接稳定性排查。

限制:部分问题依赖具体版本升级,需对照版本号;公共 RPC 端点可能限流或不稳定;Solana devnet/testnet 可用性取决于所连接 MetaMask 版本,且需确认会话是否授予对应作用域。资料未提供收费、价格或平台支持范围等信息。