如何在 Spock 测试中模拟静态工具类方法并返回原始输入

本文介绍在 java 项目中使用 spock 测试调用静态工具方法（如 `utils.fixmap()`）的场景时，如何通过 mockito 静态 mock 实现“原样返回输入”的行为，并强调更优的可测试性设计原则。

在典型的 Java-Spock 测试环境中，当被测方法依赖静态工具类（如 Utils.fixMap(originalMap)），直接使用 Spock 内置的 Mock 或 Stub 是无法生效的——因为 Spock 的 mock 机制仅适用于实例对象，不支持对静态方法进行拦截或替换。

✅ 正确方案：结合 Mockito 4+ 进行静态方法 Mock

从 Mockito 3.4.0 开始（推荐使用 4.x+），可通过 mockStatic() 安全地模拟静态方法。需引入以下依赖（Gradle 示例）：

testImplementation 'org.mockito:mockito-core:5.12.0'
testImplementation 'org.mockito:mockito-inline:5.12.0' // 必须启用 inline agent 才能 mock static

并在 Spock 测试中按如下方式编写：

import org.mockito.MockedStatic
import static org.mockito.Mockito.*

class YourServiceSpec extends Specification {
    def "mathod() should return fixed map (same as input)"() {
        given:
        MockedStatic utilsMock = mockStatic(Utils)
        utilsMock.when({ Utils.fixMap(_) }).thenAnswer { invocation ->
            return invocation.getArgument(0) // 原样返回传入的 Map
        }

  
      when:
        Map> result = new YourClass().mathod()

        then:
        result != null
        // 可进一步验证结构一致性（如 key 数量、内容未被修改等）

        cleanup:
        utilsMock.close() // ⚠️ 必须显式关闭，避免影响其他测试
    }
}

? 提示：thenAnswer 比 thenReturn 更灵活，可访问实际参数；getArgument(0) 精准获取传入的 originalMap，确保“返回输入”语义严格成立。

⚠️ 注意事项与风险提示

• mockito-inline 是必需的：默认的 mockito-core 无法 mock 静态方法，缺少 inline 模块将导致 MockitoException: Cannot mock/spy class ...。
• 作用域控制：MockedStatic 是线程局部且需手动 close()，否则可能造成测试污染（如后续测试意外复用该 mock 行为）。
• JVM 参数限制：某些构建环境（如 Gradle 的 fork 模式）需确保测试运行时启用 --add-opens java.base/java.lang=ALL-UNNAMED（Java 17+）以兼容 inline agent。

✅ 更可持续的替代方案：重构以提升可测试性

静态工具方法虽简洁，却天然阻碍单元测试和行为替换。更符合面向对象与 SOLID 原则的做法是：

1. 将 Utils 抽象为接口 + 可注入实现：

   public interface MapFixer {
        Map> fixMap(Map> input);
   }

2. 在目标类中通过构造器/字段注入：

   private final MapFixer mapFixer;
   public YourClass(MapFixer mapFixer) { this.mapFixer = mapFixer; }

3. Spock 中轻松 Stub：

   MapFixer fixer = Stub(MapFixer) {
       fixMap(_) >> { Map m -> m }
   }

这种方式无需字节码增强、无运行时开销、测试隔离性更强，也便于未来切换实现（如添加日志、缓存、降级逻辑）。

总结

• ✅ 短期解法：用 Mockito.mockStatic(Utils).when(...).thenAnswer(...) 实现静态方法“回声式”返回；
• ? 避免滥用：静态 mock 应是临时过渡手段，而非长期架构选择；
• ✅ 长期建议：通过依赖注入解耦工具逻辑，让代码更清晰、可测、可维护。测试不应迁就坏味道，而应驱动设计进化。