使用Mockito.mock()与ObjectMapper时出现InvalidDefinitionException异常

问题详情 #

尝试用Jackson的ObjectMapper序列化Mockito生成的Mock对象时，会抛出InvalidDefinitionException，该问题与具体Mock的目标对象无关。

触发异常的代码：

ObjectMapper objectMapper = new ObjectMapper();
objectMapper.writeValueAsString(mock(Object.class));

异常堆栈信息：

com.fasterxml.jackson.databind.exc.InvalidDefinitionException: No serializer found for class org.mockito.internal.creation.bytebuddy.ByteBuddyCrossClassLoaderSerializationSupport and no properties discovered to create BeanSerializer (to avoid exception, disable SerializationFeature.FAIL_ON_EMPTY_BEANS) (through reference chain: org.mockito.codegen.Object$MockitoMock$nY0RyieU["mockitoInterceptor"]->org.mockito.internal.creation.bytebuddy.MockMethodInterceptor["serializationSupport"])

使用的依赖版本：

• jackson-databind v2.14.0
• Mockito v4.8.1

可行解决方案 #

1. 禁用Jackson的空Bean序列化失败特性 #

这是最直接的解决方式，让Jackson忽略没有可序列化属性的类：

ObjectMapper objectMapper = new ObjectMapper();
// 关闭空Bean序列化失败的开关
objectMapper.disable(SerializationFeature.FAIL_ON_EMPTY_BEANS);
objectMapper.writeValueAsString(mock(Object.class));

注意：该设置全局生效，所有无序列化属性的类都会被序列化为{}，若业务中有严格校验空Bean的场景，需谨慎使用。

2. 为Mockito内部类注册自定义序列化器 #

如果不想全局修改Jackson配置，可针对Mockito的ByteBuddyCrossClassLoaderSerializationSupport类单独处理：

ObjectMapper objectMapper = new ObjectMapper();
SimpleModule mockitoModule = new SimpleModule();

// 为目标类添加自定义序列化器
mockitoModule.addSerializer(ByteBuddyCrossClassLoaderSerializationSupport.class, new JsonSerializer<ByteBuddyCrossClassLoaderSerializationSupport>() {
    @Override
    public void serialize(ByteBuddyCrossClassLoaderSerializationSupport value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        // 可根据需求写入内容，示例为序列化空对象
        gen.writeStartObject();
        gen.writeEndObject();
    }
});

objectMapper.registerModule(mockitoModule);
objectMapper.writeValueAsString(mock(Object.class));

这种方式仅影响Mockito相关内部类，不会干扰其他业务代码的序列化逻辑。

3. 避免直接序列化Mock对象 #

Mock对象本质是测试用替身，不适合作为序列化目标。若业务逻辑需要序列化操作，建议使用真实对象或专门的DTO（数据传输对象）替换Mock对象，从根源上规避该问题。

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