多连接管理与切换

30 秒回答

useConnections 返回所有活动连接组成的列表，useConnection 返回当前连接；useSwitchConnection 通过 mutate({ connector }) 切换当前连接。useConnectors 返回可用 connector 列表，与已建立的连接不同。切换或断开后，表单、待签内容等绑定旧连接的业务状态需要显式清理。实现差异与工程取舍见深入回答。

深入回答

• 【实现行为】useConnections 返回活动连接列表，文档示例直接读取该列表用于渲染（依据：wagmi useConnections §Usage）。
• 【实现行为】useConnection 返回当前连接及其状态；不要把它与 useConnections 的列表混为一谈（依据：wagmi useConnection §Return Type、useConnections §Usage）。
• 【实现行为】useSwitchConnection 的用法是 switchConnection.mutate({ connector: connection.connector })（依据：wagmi useSwitchConnection §Usage）。
• 【实现行为】useSwitchConnection 的结果包含 status、isPending 等 mutation 状态（依据：wagmi useSwitchConnection §Return Type 的 status、isPending）。
• 【实现行为】useSwitchConnection 返回的 connectors 已被标记为废弃，迁移指南建议改用 useConnections 并从连接中导出 connector（依据：wagmi useSwitchConnection §Return Type 的 connectors（deprecated）、从 v2 迁移到 v3 §Removed useDisconnect().connectors & useSwitchConnection().connectors）。
• 【工程经验】切换后清理业务状态：表单、待签内容与提示都要与被切换的连接解耦（工程经验，无规范依据）。
• 【工程经验】切换前处理仍在飞行的请求：作废或取消与旧连接绑定的流程（工程经验，无规范依据）。
• 【工程经验】断开当前连接后，界面回到与「无连接」一致的空状态，而不是保留旧地址（工程经验，无规范依据）。
• 【工程经验】把连接列表渲染与「当前连接」展示分开，避免切换瞬间出现两个高亮项（工程经验，无规范依据）。

常见错误

• 把 useConnections 与 useConnectors 混用（【实现行为】前者是活动连接列表，后者是可用 connector 列表；依据：wagmi useConnections、useConnectors）。
• 继续依赖 useSwitchConnection().connectors（【实现行为】该返回值已废弃；依据：wagmi v2→v3 迁移指南）。
• 切换后不清理旧连接的 pending 流程（【工程经验】）。
• 断开当前连接后界面未回到空状态（【工程经验】）。
• 用地址而非连接标识渲染列表项，切换后出现错位（【工程经验】）。

面试官追问

1. 用户同时连接两个钱包时，签名请求应该发给谁？
2. 切换连接后，按链与地址隔离的查询缓存如何处理？
3. 断开其中一条连接与断开全部连接，交互差异是什么？
4. 多连接列表的持久化要考虑哪些隐私边界？
5. useConnections 与 useConnectors 各自适合渲染什么？

评分标准

初级回答

• 知道 useConnections 返回活动连接列表，useConnection 返回当前连接，useSwitchConnection 用于切换。
• 知道活动连接与可用 connector 是两份不同的数据。

中级回答

• 能说明切换后的状态清理范围，包括表单与待签内容。
• 能说明断开当前连接后的空状态处理。

高级回答

• 能设计多连接场景下的事件、缓存与请求归属规则。
• 能说明切换连接对查询隔离与用户预期的影响。

参考资料

• wagmi：useConnection（§Return Type）
• wagmi：useConnections（§Usage）
• wagmi：useSwitchConnection（§Usage、§Return Type）
• wagmi：从 v2 迁移到 v3（§Removed useDisconnect().connectors & useSwitchConnection().connectors）