Capacitor社交登录插件中Google登录"activity cancelled by user"错误解析

Capacitor社交登录插件中Google登录"activity cancelled by user"错误解析

问题现象

在使用Capacitor-social-login插件实现Google登录功能时，开发者可能会遇到一个常见错误："Google Sign-In failed: activity is cancelled by the user"。这个错误通常表现为：账户选择界面能够正常弹出，但当用户选择完Google账户后，系统却抛出此异常而非成功登录。

错误原因深度分析

经过技术验证，该问题主要与Android应用的签名证书SHA-1指纹不匹配有关。具体可分为两种情况：

1. 发布版与调试版证书混淆：开发者可能错误地使用了发布版的SHA-1指纹（从Play控制台获取）来配置调试版本的应用，导致签名验证失败。

2. Firebase等第三方服务干扰：当应用集成了Firebase App Distribution等服务时，这些服务可能会在构建过程中自动替换调试证书，使得实际运行的证书与开发者预期的不同。

解决方案

方案一：获取正确的调试证书指纹

1. 通过Android Studio终端执行以下命令获取当前调试版本的SHA-1：

./gradlew signingReport

2. 或者在项目目录下使用keytool命令：

keytool -keystore path_to_keystore -list -v

方案二：处理Firebase干扰情况

如果使用了Firebase服务，需要额外检查：

1. 登录Firebase控制台
2. 进入App Distribution > View Certificate
3. 获取Firebase使用的调试证书SHA-1指纹

最佳实践建议

1. 开发与生产环境分离：为调试版和发布版分别创建不同的OAuth客户端ID，避免混淆。

2. 多环境配置检查：当使用CI/CD管道或第三方分发服务时，务必确认实际运行的签名证书与Google Cloud Console中配置的一致。

3. 证书指纹验证：定期验证应用的签名证书，特别是在集成新服务或更改构建配置后。

总结

"activity cancelled by user"错误虽然提示信息看似用户取消了操作，但实际上往往是后端验证失败导致的。通过正确配置签名证书SHA-1指纹，并注意区分不同构建环境，开发者可以有效解决此类问题，确保Google登录功能正常工作。