Wagmi 钱包连接与断开问题解析：深入理解 useDisconnect 钩子的正确使用

问题现象

在使用 Wagmi 框架开发 DApp 时，开发者可能会遇到一个奇怪的现象：当用户反复连接和断开钱包时，某些情况下无法正常断开连接。特别是在使用 MetaMask 钱包时，这个问题尤为明显。

问题重现

通过简化测试场景，我们可以清晰地观察到这个问题：

1. 用户首次点击连接钱包按钮，成功连接 MetaMask
2. 点击断开按钮，钱包正常断开
3. 再次点击连接按钮，成功连接
4. 此时点击断开按钮，发现无法正常断开连接

问题根源

经过深入分析，这个问题主要源于 Wagmi 框架中 injected() 连接器的实现方式与现代钱包生态的兼容性问题。

在传统的 Web3 开发中，我们通常直接使用 window.ethereum 对象来与钱包交互。然而，随着 EIP-6963 标准的推出，现代钱包生态正在向多注入提供者发现机制转变。Wagmi 默认启用了 multiInjectedProviderDiscovery 选项，这在与传统 injected() 连接器一起使用时可能导致状态管理异常。

解决方案

针对这个问题，开发者有以下几种解决方案：

方案一：禁用多注入提供者发现

在创建 Wagmi 配置时，显式地关闭 multiInjectedProviderDiscovery 选项：

const config = createConfig({
  // ...其他配置
  connectors: [
    injected({
      target: "metaMask",
    }),
  ],
  multiInjectedProviderDiscovery: false,
});

方案二：使用 EIP-6963 兼容的连接器

更推荐的做法是使用符合 EIP-6963 标准的钱包连接方式，这代表了未来的发展方向：

import { createConfig, http } from "wagmi";
import { walletConnect, injected } from "wagmi/connectors";

const config = createConfig({
  connectors: [
    walletConnect({ projectId: "..." }),
    // 或者使用特定钱包的连接器而非通用的injected
  ],
});

最佳实践建议

1. 避免直接使用 injected()：随着 EIP-6963 的普及，直接使用 window.ethereum 的方式将逐渐被淘汰。

2. 明确指定目标钱包：如果必须使用注入式连接器，应该明确指定目标钱包，如 injected({ target: "metaMask" })。

3. 保持依赖更新：确保 Wagmi 和 Viem 版本保持最新，以获得最佳兼容性。

4. 类型检查：注意 TypeScript 版本兼容性，避免因类型系统不匹配导致的潜在问题。

总结

Wagmi 框架正在积极适应 Web3 生态的发展变化，从传统的 window.ethereum 方式向更现代的 EIP-6963 标准过渡。开发者在使用钱包连接功能时，应当了解这一背景，选择合适的连接方式，避免直接使用可能被弃用的 API。通过采用推荐的解决方案，可以确保应用在不同钱包环境下都能提供稳定可靠的连接/断开体验。