如何在JUnit中正确mock UriComponentsBuilder避免空HTTP URL异常

你遇到HTTP url cannot be null异常的核心原因有两个：

• UriComponentsBuilder.fromHttpUrl()是静态方法，普通Mockito配置无法直接mock静态方法，你写在Mockito.when()中的fromHttpUrl调用实际执行了真实的类方法，而ArgumentMatchers.anyString()在真实方法执行时拿到的入参为null，触发了Spring的参数校验抛出异常。
• UriComponentsBuilder是链式调用结构，你需要保证每一步链式方法调用都返回mock实例，才能完成后续的链式逻辑配置。

前置依赖 #

确保你使用的Mockito版本在3.4及以上，且引入了mockito-inline依赖，该依赖支持静态方法mock能力。

实现代码 #

import org.mockito.ArgumentMatchers;
import org.mockito.MockedStatic;
import org.mockito.Mockito;
import org.springframework.web.util.UriComponentsBuilder;
import org.junit.jupiter.api.Test;

public class UriComponentsBuilderTest {

    @Test
    public void testUriBuild() {
        // 1. 先创建UriComponentsBuilder的mock实例
        UriComponentsBuilder mockBuilder = Mockito.mock(UriComponentsBuilder.class);
        
        // 2. 使用try-with-resources包裹静态mock作用域，避免影响其他测试用例
        try (MockedStatic<UriComponentsBuilder> mockedStatic = Mockito.mockStatic(UriComponentsBuilder.class)) {
            // 3. mock静态方法fromHttpUrl，任意字符串入参都返回我们的mock实例
            mockedStatic.when(() -> UriComponentsBuilder.fromHttpUrl(ArgumentMatchers.anyString()))
                    .thenReturn(mockBuilder);
            // 4. mock链式调用的queryParam方法，返回mock实例本身支持后续链式调用
            Mockito.when(mockBuilder.queryParam(ArgumentMatchers.anyString(), ArgumentMatchers.any(Object.class)))
                    .thenReturn(mockBuilder);
            
            // 可根据你的业务逻辑补充其他链式方法的mock，比如toUriString、build等
            Mockito.when(mockBuilder.toUriString()).thenReturn("https://test.com?externalReference=testKey");

            // 此处放置你的业务测试代码，触发UriComponentsBuilder相关逻辑
        }
    }
}

• 静态mock的作用域仅限于try-with-resources块内部，出块后自动恢复原类的静态方法行为，不会干扰其他测试用例。
• 如果需要针对特定的url入参、特定的参数名做更精确的mock匹配，把ArgumentMatchers.anyString()替换为对应具体值或者更精准的匹配器即可。

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