Android中Kotlin BroadcastReceiver的'onReceive overrides nothing'错误修复

问题场景 #

在Flutter混合开发的Android模块中，用Kotlin实现PhoneCallReceiver继承BroadcastReceiver时，出现onReceive overrides nothing编译错误，相关代码与配置如上所示。

可能的原因及修复方案 #

1. 清理项目缓存并重新构建 #

Android Studio的缓存有时会导致错误的方法重写判定，执行以下步骤：

• 点击菜单栏 Build -> Clean Project
• 完成后点击 Build -> Rebuild Project

2. 确认BroadcastReceiver的导入路径正确 #

确保代码中导入的是Android原生的BroadcastReceiver类，而非其他库的实现：

import android.content.BroadcastReceiver

避免误导入androidx.core.content.BroadcastReceiver或其他第三方库中的同名类（除非项目明确依赖AndroidX并使用对应类）。

3. 检查Kotlin与Android Gradle插件版本兼容性 #

在项目根目录的build.gradle文件中，确保Kotlin版本与Android Gradle插件（AGP）版本匹配：
示例配置（根据实际项目调整版本）：

buildscript {
    ext {
        kotlin_version = '1.8.22'
        agp_version = '7.4.2'
    }
    dependencies {
        classpath "com.android.tools.build:gradle:$agp_version"
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

4. 修正namespace与applicationId不一致的潜在问题 #

当前模块的namespace为com.example.voicenote，但applicationId为org.eierc.voicenote，虽然这不会直接导致编译错误，但可能引发类路径混淆。建议将两者统一：
在app/build.gradle的defaultConfig块中修改：

defaultConfig {
    applicationId = "com.example.voicenote"
    // 其他配置保持不变
}

额外注意事项（运行时相关） #

• Android 8.0（API 26）及以上，静态注册的PHONE_STATE广播可能无法正常接收，建议改用动态注册方式。
• 启动服务时，需使用startForegroundService替代startService，并在服务内部调用startForeground展示通知，否则会触发ANR。

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