测试带@AndroidEntryPoint注解的BroadcastReceiver类时遇异常求解决

问题重现 #

使用@AndroidEntryPoint注解的BroadcastReceiver，在测试中手动实例化并赋值mock依赖后，调用onReceive时抛出IllegalStateException: Could not find an Application in the given context异常。原因是Hilt生成的代理类会在onReceive中尝试从Context获取Application来初始化组件，但测试用的mock Context未关联有效Application实例，且手动赋值依赖绕不开Hilt的代理逻辑。

解决方案 #

根据测试类型（本地单元测试/仪器化测试）选择对应方案：

方案1：本地单元测试（无需Hilt运行） #

本地单元测试无需启动Android环境，推荐抽离业务逻辑，避免直接测试BroadcastReceiver的Hilt代理类：

1. 重构BroadcastReceiver，将业务逻辑移至独立类：

// 新增业务处理类，便于单元测试
class BroadcastDataHandler @Inject constructor(private val myRepository: MyRepository) {
    fun handleUpdate() {
        myRepository.updateData()
    }
}

@AndroidEntryPoint
class MyBroadcast : BroadcastReceiver() {
    @Inject lateinit var dataHandler: BroadcastDataHandler

    override fun onReceive(context: Context?, intent: Intent?) {
        dataHandler.handleUpdate()
    }
}

2. 直接测试业务处理类：

class BroadcastDataHandlerTest {
    @RelaxedMockK
    lateinit var mockMyRepository: MyRepository

    private lateinit var handler: BroadcastDataHandler

    @Before
    fun setUp() {
        MockKAnnotations.init(this)
        handler = BroadcastDataHandler(mockMyRepository)
    }

    @Test
    fun shouldTriggerDataUpdate() {
        handler.handleUpdate()
        verify { mockMyRepository.updateData() }
    }
}

如果无法重构代码，可使用Robolectric提供有效上下文，配合Hilt测试注解：

@RunWith(RobolectricTestRunner::class)
@HiltAndroidTest
class MyBroadcastTest {
    @get:Rule
    val hiltRule = HiltAndroidRule(this)

    @BindValue
    @RelaxedMockK
    lateinit var mockMyRepository: MyRepository

    @Inject
    lateinit var myBroadcast: MyBroadcast

    @Before
    fun setUp() {
        MockKAnnotations.init(this)
        hiltRule.inject()
    }

    @Test
    fun shouldUpdateDataOnReceivingBroadcast() {
        val context = ApplicationProvider.getApplicationContext<Context>()
        myBroadcast.onReceive(context, Intent())
        
        verify { mockMyRepository.updateData() }
    }
}

方案2：仪器化测试（使用Hilt完整注入） #

在设备/模拟器上运行的测试，需使用Hilt测试框架提供的注解和规则：

@HiltAndroidTest
class MyBroadcastTest {
    @get:Rule
    val hiltRule = HiltAndroidRule(this)

    @BindValue
    @RelaxedMockK
    lateinit var mockMyRepository: MyRepository

    @Inject
    lateinit var myBroadcast: MyBroadcast

    @Before
    fun setUp() {
        MockKAnnotations.init(this)
        hiltRule.inject()
    }

    @Test
    fun shouldUpdateDataOnReceivingBroadcast() {
        val context = ApplicationProvider.getApplicationContext<Context>()
        myBroadcast.onReceive(context, Intent())
        
        verify { mockMyRepository.updateData() }
    }
}

关键说明：

• @HiltAndroidTest：标记测试类使用Hilt注入
• HiltAndroidRule：负责初始化Hilt组件
• @BindValue：将mock的MyRepository绑定到Hilt组件中，替代真实实现
• 使用ApplicationProvider.getApplicationContext()获取测试用的有效上下文，避免mock Context导致的异常

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