如何在 Spock 中正确模拟静态工具类方法并返回原始输入_技术教程

本文介绍在 java 项目中使用 groovy/spock 测试含静态工具方法（如 `utils.fixmap()`）的代码时，如何安全、有效地实现行为模拟——重点说明为何直接 mock 静态方法不推荐，并提供可维护的重构方案与替代测试策略。

在 Java + Spock 的测试实践中，遇到类似以下代码时会面临模拟困境：

public Map> method() {
    Map> originalMap = createMap();
    return Utils.fixMap(originalMap); // ← 静态工具方法，无法被 Spock 原生 mock
}

Spock 的 Mock() 和 Stub() 仅支持对实例对象（即接口或可实例化类）进行行为模拟，而 Utils.fixMap() 是静态方法，Spock 不支持直接 mock 静态方法（无论是否为 Groovy 类）。因此，如下写法在 Java 中无效：

// ❌ 错误：Spock 无法 mock 静态类或静态方法
Utils mockUtils = Mock(Utils) { ... } // 编译失败或运行时异常

✅ 推荐方案：重构为可注入依赖（最佳实践）

根本解法是消除静态耦合，将 Utils 抽象为可注入的服务：

// 1. 定义接口（解耦调用方与实现）
public interface MapFixer {
     Map> fixMap(Map> input);
}

// 2. 提供默认实现（保留原有逻辑）
public class UtilsMapFixer implements MapFixer {
    @Override
    public  Map> fixMap(Map> input) {
        return Utils.fixMap(input); // 委托给原静态方法（仅此处调用）
    }
}

// 3. 修改被测类，通过构造函数注入
public class MyService {
    private final MapFixer mapFixer;

    public MyService(MapFixer mapFixer) {
        this.mapFixer = mapFixer;
    }

    public Map> method() {
        Map
, Set> originalMap = createMap();
        return mapFixer.fixMap(originalMap); // ← 现在可轻松 mock！
    }
}

此时 Spock 测试变得简洁可靠：

def "method returns fixed map (which is same as input)"() {
    given:
    MapFixer fixer = Mock(MapFixer) {
        fixMap(_) >> { Map input -> input } // 直接返回传入参数
    }
    MyService service = new MyService(fixer)

    when:
    Map> result = service.method()

    then:
    result == [key: [] as Set] // 示例断言，取决于 createMap() 行为
}

⚠️ 备选方案（不推荐）：使用 Mockito Mock Static（仅限必要场景）

若因历史约束暂无法重构，可借助 Mockito 5.0+ 的静态 mock 支持（需 mockito-inline）：

// build.gradle（添加依赖）
testImplementation 'org.mockito:mockito-core:5.12.0'
testImplementation 'org.mockito:mockito-inline:5.12.0'

Spock 测试中使用：

import static org.mockito.Mockito.*
import static org.mockito.Mockito.mockStatic

def "test with mocked static Utils (NOT RECOMMENDED)"() {
    given:
    def utilsMock = mockStatic(Utils.class)
    utilsMock.when({ Utils.fixMap(_) }).thenAnswer({ invocation ->
        invocation.getArguments()[0] // 返回第一个参数（即 originalMap）
    })

    when:
    Map> result = new MyService().method()

    then:
    result != null
    // 注意：静态 mock 会影响 JVM 全局状态，可能干扰其他测试，务必 cleanup
    cleanup:
    utilsMock.close()
}