MetaMask移动端WalletConnect二维码扫描问题分析与修复

问题背景

MetaMask移动端应用在7.50.0版本中出现了WalletConnect二维码扫描功能失效的问题。当用户尝试通过扫描WalletConnect生成的二维码来连接DApp时，应用无法正确识别和处理二维码信息，导致连接失败。

问题表现

用户在使用MetaMask移动应用扫描WalletConnect二维码时，主要遇到两种错误情况：

1. 应用显示"无法识别的二维码"错误提示
2. 即使二维码被识别，应用也会卡在"正在连接MetaMask"状态，无法完成连接

技术分析

经过开发团队深入调查，发现该问题由两个独立但相关的技术因素导致：

1. 二维码解析错误

第一个问题源于近期合并的深度链接(deep linking)功能相关PR。该修改在尝试解析WalletConnect链接时错误地抛出了异常，导致应用无法正确处理二维码中包含的连接信息。

2. 连接状态卡死问题

第二个问题与新架构(New Architecture)的启用有关。技术团队通过对比测试发现：

• 在新架构启用前的版本中，WalletConnect连接功能工作正常
• 启用新架构后，应用会卡在连接状态
• 错误日志显示_nativeInterface.default.getCurrentState is not a function的TypeError

解决方案

针对上述两个问题，开发团队采取了以下修复措施：

1. 对于二维码解析错误，通过temp/integrate-interstitial分支中的修改修复了深度链接处理逻辑

2. 对于连接状态问题，通过将react-native-netinfo库更新至最新版本解决了兼容性问题

验证结果

修复后，团队在iOS和Android平台上进行了全面测试：

• iOS设备：成功扫描二维码并建立WalletConnect连接
• Android设备：同样能够正常完成整个连接流程

技术启示

这个案例为我们提供了几个重要的技术经验：

1. 架构升级需全面测试：新架构引入可能影响看似不相关的功能模块
2. 依赖管理的重要性：及时更新第三方库可以解决许多兼容性问题
3. 错误处理要谨慎：过于严格的错误处理可能阻止合法操作

总结

MetaMask团队通过快速响应和深入技术分析，在短时间内定位并修复了WalletConnect二维码扫描功能的问题。这次修复不仅解决了当前版本的问题，也为未来的功能开发和架构升级积累了宝贵经验。