为何OPPO、一加等定制OS设备无法通过SmsRetrieverClient检测短信OTP？

核心原因排查 #

ColorOS对短信监听、后台服务有严格的权限限制，以下是常见触发失效的场景：

• 应用被系统归类为"耗电高"或"后台限制"名单，SmsRetrieverClient的服务被强制终止
• 短信模板不符合ColorOS的隐性规则（即使符合Google官方规范）
• AppSignatureHelper生成的签名哈希值与系统识别的不一致（ColorOS可能对签名处理有差异）

具体解决步骤 #

1. 验证签名哈希值的正确性 #

• 不要仅依赖AppSignatureHelper的代码生成，手动通过命令行计算签名哈希：

  keytool -exportcert -alias YOUR_ALIAS -keystore YOUR_KEYSTORE_PATH | xxd -p | tr -d "[:space:]" | echo -n YOUR_PACKAGE_NAME `cat` | sha256sum | tr -d "[:space:]-" | xxd -r -p | base64 | cut -c1-11
  

• 对比手动计算值与AppSignatureHelper返回的结果，确保两者完全一致（ColorOS对签名哈希的校验更严格）

2. 调整短信模板适配ColorOS规则 #

除了Google要求的格式，额外满足：

• 短信开头必须包含[OTP]或【验证码】（ColorOS对中文标识兼容性更好）
• 签名哈希必须放在短信末尾，且前后无多余字符
• 短信内容长度控制在140字符以内，避免被系统拆分

3. 解除应用的后台限制 #

引导用户手动开启权限：

• 路径：设置 > 电池 > 应用耗电管理 > 找到你的应用 > 设置为"无限制"
• 路径：设置 > 应用管理 > 你的应用 > 权限管理 > 开启"后台弹出界面"和"自启动"权限
• 代码中可通过Intent跳转对应设置页面，提示用户操作

4. 备用方案：结合广播监听与SmsRetrieverClient #

• 同时注册SMS_RECEIVED广播（需READ_SMS权限），作为SmsRetrieverClient的 fallback
• 注意：Android 10+需要申请ACCESS_FINE_LOCATION权限才能接收短信广播（ColorOS在Android 10+对广播限制更严）

5. 针对ColorOS特定版本的适配 #

• ColorOS 11及以上：确保应用targetSdkVersion >= 30，否则后台服务会被限制
• ColorOS 10及以下：关闭应用的"纯净后台"功能

内容的提问来源于stack exchange，提问作者Davin Vong