使用 wagmi + viem 工具链，在前端实现高质量的钱包连接模块，包括状态管理、自动连接、网络切换、多连接器支持等核心功能。
本章总结 Web3 登录中 20 个常见失败问题，涵盖连接、签名、验签与 JWT 管理，并提供排查建议与用户提示策略。强调前后端一致性、错误码体系与异常处理机制是保障登录系统健壮性的关键。
Henry Wei