Java中Mock FlagsmithClient出现空指针异常的原因排查

你遇到的空指针，本质是**FlagsmithClient.getEnvironmentFlags()方法未被正确Mock，返回了null**，导致flags变量为空，调用isFeatureEnabled时触发异常。

核心修复思路 #

测试时需要确保两个关键Mock点：

1. Mock FlagsmithClient的getEnvironmentFlags()方法，返回一个非null的Flags对象（可以是Mock实例）。
2. Mock Flags对象的isFeatureEnabled方法，返回预期的布尔值。

完整测试代码示例 #

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.InjectMocks;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;
import com.flagsmith.FlagsmithClient;
import com.flagsmith.models.Flags;

import static org.junit.jupiter.api.Assertions.assertTrue;
import static org.mockito.Mockito.*;

@ExtendWith(MockitoExtension.class)
class FlagsmithGatewayTest {

    @Mock
    private FlagsmithClient flagsmithClient;

    @Mock
    private Flags flags;

    @InjectMocks
    private FlagsmithGateway flagsmithGateway;

    @Test
    void isEnabled_ShouldReturnTrue_WhenFeatureIsEnabled() {
        String testFlag = "TEST_FEATURE";
        
        // 让client返回mock的flags对象
        when(flagsmithClient.getEnvironmentFlags()).thenReturn(flags);
        // 配置flags的方法返回预期结果
        when(flags.isFeatureEnabled(testFlag)).thenReturn(true);

        boolean result = flagsmithGateway.isEnabled(testFlag);

        assertTrue(result);
        // 验证调用逻辑符合预期
        verify(flagsmithClient).getEnvironmentFlags();
        verify(flags).isFeatureEnabled(testFlag);
    }
}

额外注意事项 #

• 确认测试类添加了@ExtendWith(MockitoExtension.class)，否则Mockito无法初始化Mock对象，会导致依赖注入失败。
• 如果getEnvironmentFlags()调用时带有参数（比如用户上下文），要在when中匹配对应参数，比如when(flagsmithClient.getEnvironmentFlags(anyString())).thenReturn(flags)。
• 不要直接依赖真实的Flags实例，用Mock可以完全控制返回结果，避免测试受第三方服务影响。

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