Wagmi项目中Injected连接器的多账户连接问题解析

问题背景

在Wagmi项目的injected连接器实现中，当开发者启用shimDisconnect选项并尝试通过Metamask等钱包连接多个账户时，会出现当前选中账户与实际显示账户不一致的问题。这个问题源于Wagmi在连接过程中获取账户列表的方式存在差异。

技术原理分析

Wagmi的injected连接器在连接钱包时主要通过两种方式获取账户列表：

1. 权限请求方式：使用wallet_requestPermissionsAPI获取账户列表，这种方式返回的账户顺序与钱包中账户选择对话框的显示顺序一致。

2. 账户请求方式：使用eth_requestAccountsAPI获取账户列表，这种方式返回的数组中第一个位置始终是钱包中当前选中的账户，不受钱包内部排序影响。

问题复现场景

当用户满足以下条件时，可以稳定复现该问题：

1. 钱包中创建了多个账户
2. 当前选中的账户不是钱包账户列表中的第一个
3. 在连接时选择了多个账户（包括非首位的当前选中账户）
4. 启用了shimDisconnect选项

此时Wagmi状态中显示的"当前账户"会是权限请求返回列表中的第一个账户，而非用户实际在钱包中选中的账户。

问题根源

问题的本质在于两种API返回的账户排序逻辑不同：

• wallet_requestPermissions返回的是钱包内部存储的原始账户顺序
• eth_requestAccounts则会主动将当前选中账户调整到数组首位

而Wagmi在初始连接时优先使用权限请求方式获取账户列表，导致获取的顺序与用户预期不符。

解决方案建议

最合理的解决方案是在使用wallet_requestPermissions获取权限后，再额外调用一次eth_requestAccounts来获取正确的账户排序。这种方式：

1. 保持了现有的权限请求流程
2. 通过二次请求确保账户顺序正确
3. 与钱包的实际行为保持一致
4. 不会增加显著的性能开销

技术影响评估

该问题主要影响以下场景：

1. 多账户连接的应用
2. 依赖当前选中账户进行链上操作的功能
3. 需要精确显示用户当前钱包状态的UI

虽然页面刷新后通过自动重连可以获取正确的账户顺序，但这会给用户带来困惑和不一致的体验。

最佳实践建议

对于开发者而言，在Wagmi修复该问题前，可以采取以下临时解决方案：

1. 对于关键操作，在连接后手动验证一次当前账户
2. 考虑禁用多账户连接功能
3. 在UI中加入账户状态验证提示

该问题的存在提醒我们在处理钱包连接时需要特别注意不同API的行为差异，特别是在多账户场景下的边缘情况处理。