React Native原生Java模块测试在androidTest正常但Test/全测试失败求助

核心问题拆解 #

1. 测试目录差异导致的本质矛盾 #

android/app/src/test/ 是本地单元测试目录，测试代码运行在JVM而非真实Android系统环境中，没有完整的Application上下文和Android文件系统支持。SoLoader初始化依赖ApplicationInfo.nativeLibraryDir这类系统提供的路径，本地测试中这些值均为空，必然触发空指针。因此依赖Android系统API的原生模块测试，绝对不能放在这个目录，必须留在android/app/src/androidTest/。

2. androidTest全量测试失败的诱因 #

单独/按文件夹运行测试时，Android Studio会为每个测试类单独初始化完整的Instrumented测试环境（包含有效Application上下文）；但运行「所有测试」时，容易出现以下问题：

• 测试执行顺序混乱，部分测试在React Native环境初始化完成前就调用了依赖SoLoader的代码；
• 部分测试类未正确配置测试Runner（如AndroidJUnit4），导致应用上下文未被正确注入；
• 多测试连续执行时，应用进程被复用，SoLoader的初始化状态被污染或重置。

解决方案（适配CI全量测试需求） #

（1）固定测试目录归属 #

所有依赖Android系统API（包括SoLoader、原生模块调用）的测试，必须保留在android/app/src/androidTest/目录，禁止移至test/目录。

（2）统一测试环境初始化 #

在androidTest目录下创建基础测试类，提前完成SoLoader的初始化，所有原生模块测试类继承该类：

import android.content.Context;
import androidx.test.core.app.ApplicationProvider;
import com.facebook.soloader.SoLoader;
import org.junit.BeforeClass;

public class BaseRNTest {
    @BeforeClass
    public static void setUpGlobal() {
        Context appContext = ApplicationProvider.getApplicationContext();
        // 手动初始化SoLoader，绕过MainApplication的onCreate依赖
        SoLoader.init(appContext, null);
        // 若需加载特定SO库，可手动指定
        // SoLoader.loadLibrary("your-native-module-lib");
    }
}

测试类示例：

import org.junit.Test;
import org.junit.runner.RunWith;
import androidx.test.ext.junit.runners.AndroidJUnit4;

@RunWith(AndroidJUnit4.class)
public class YourNativeModuleTest extends BaseRNTest {
    @Test
    public void testNativeFunction() {
        // 测试逻辑
    }
}

（3）启用测试进程隔离 #

通过Test Orchestrator为每个测试类创建独立应用进程，避免环境污染：
在android/app/build.gradle中添加配置：

android {
    testOptions {
        instrumentedTests {
            execution 'ANDROIDX_TEST_ORCHESTRATOR'
        }
    }
}

dependencies {
    androidTestImplementation 'androidx.test:orchestrator:1.4.2'
    androidTestUtil 'androidx.test:orchestrator:1.4.2'
}

（4）排查异常测试初始化 #

检查所有androidTest测试类：

• 禁止在静态代码块或@BeforeClass中提前调用依赖SoLoader的代码；
• 确保所有测试类都声明了正确的Runner（如@RunWith(AndroidJUnit4.class)）；
• 若使用自定义测试Application，需确保它正确初始化SoLoader。

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