Android插桩测试在AWS Device Farm运行时遇Activity启动异常

阿华AIGC实验室

2026-5-27

解决AWS Device Farm上Fragment插桩测试启动失败的问题

看起来你遇到的问题很典型——本地测试一切正常，但到了云测试环境就掉链子，先别慌，我们一步步拆解问题：

首先确认APK一致性：你上传的确实是本地的构建吗？

AWS Device Farm运行的APK就是你上传的那两个（主应用APK + 测试APK），但这里容易踩坑的点是：

构建变体不匹配：本地你可能用debug变体测试，但上传的时候不小心传了release的主APK和debug的测试APK，或者反过来。签名、版本号、包名必须完全一致才能正常运行测试。
测试APK未正确关联：要确保上传的测试APK是主APK对应的androidTest构建产物，不是单独打包的。可以用以下命令验证两个APK的信息：
```
# 检查主APK的包名和版本
aapt dump badging your-main-app.apk | grep "package: name"
# 检查测试APK的目标包名
aapt dump badging your-test-app.apk | grep "targetPackage"
```
输出的包名必须完全一致，versionCode也要匹配。

针对Fragment测试启动失败的具体排查

你的报错Could not launch activity大概率和第三方FragmentTestRule的兼容性有关，AWS Device Farm的Instrumentation环境和本地模拟器/真机有细微差异，第三方库可能没覆盖到这些场景。给你几个调整方向：

1. 避免重复启动Fragment/Activity

看你的测试代码，Rule里已经设置了FragmentTestRule(..., true, true)——最后两个参数分别是自动初始化Fragment和自动启动Activity，但你在测试方法里又调用了fragmentTestRule.launchFragment(MyFragment())，这相当于重复创建Fragment，在AWS环境下可能触发启动异常。

可以修改Rule为手动控制启动：

@Rule
@JvmField
val fragmentTestRule = FragmentTestRule(FragmentActivity::class.java, MyFragment::class.java, false, false)

@Test
fun not_show_payment_details() {
    // 先设置测试数据
    DatabaseUtil.setUser(Driver().apply { type = Constants.INDEPENDENT_DRIVER })
    // 先启动Activity
    fragmentTestRule.launchActivity(null)
    // 再启动Fragment
    fragmentTestRule.launchFragment(MyFragment())
    // 后续断言逻辑
    val paymentDetails = fragmentTestRule.activity.getString(R.string.payment_details)
    onView(withText(paymentDetails)).check(matches(not(isDisplayed())))
}

2. 替换为AndroidX官方的FragmentScenario

第三方测试库的兼容性始终不如官方，建议迁移到AndroidX的FragmentScenario，它专门为Fragment测试设计，对各种环境的支持更好：

首先确保你的测试依赖是AndroidX版本：

androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
androidTestImplementation 'androidx.test:core:1.5.0'
androidTestImplementation 'androidx.fragment:fragment-testing:1.6.1'

然后修改测试代码：

import androidx.fragment.app.testing.launchFragmentInContainer
import androidx.test.espresso.Espresso.onView
import androidx.test.espresso.assertion.ViewAssertions.matches
import androidx.test.espresso.matcher.ViewMatchers.isDisplayed
import androidx.test.espresso.matcher.ViewMatchers.withText
import androidx.test.filters.LargeTest
import androidx.test.runner.AndroidJUnit4
import org.hamcrest.CoreMatchers.not
import org.junit.Test
import org.junit.runner.RunWith
import uk.co.stuff.MyFragment
import uk.co.stuff.models.Driver
import uk.co.stuff.utils.Constants
import uk.co.stuff.utils.DatabaseUtil
import androidx.test.platform.app.InstrumentationRegistry

@RunWith(AndroidJUnit4::class)
@LargeTest
class ProfileFragmentShould {

    @Test
    fun not_show_payment_details() {
        // 设置测试数据
        DatabaseUtil.setUser(Driver().apply { type = Constants.INDEPENDENT_DRIVER })
        // 启动Fragment
        launchFragmentInContainer<MyFragment>()
        // 获取字符串（用Instrumentation获取上下文，避免依赖Activity）
        val context = InstrumentationRegistry.getInstrumentation().targetContext
        val paymentDetails = context.getString(R.string.payment_details)
        // 断言
        onView(withText(paymentDetails)).check(matches(not(isDisplayed())))
    }
}

3. 检查Instrumentation配置

确保你的androidTest/AndroidManifest.xml里使用的是AndroidX的测试Runner，而不是旧的support版本：

<instrumentation
    android:name="androidx.test.runner.AndroidJUnitRunner"
    android:targetPackage="uk.co.stuff" />

旧的android.support.test.runner.AndroidJUnitRunner在新系统或云环境下可能存在兼容性问题。

4. 深挖AWS的详细日志

AWS Device Farm会生成完整的测试日志，不仅仅是报错信息。你可以在测试运行详情页下载device-farm-test-output.zip，里面的logcat文件会记录启动Activity/Fragment时的所有细节——比如是不是有资源加载失败、权限缺失，或者Fragment依赖的某个服务没有初始化成功，这些都可能导致启动异常。