Java Lambda中使用外部泛型参数TypeReference抛出空类型异常

问题背景 #

在Java 8环境下使用Jackson 2.12.5时，若在Lambda函数中通过new TypeReference<T>() {}创建类型引用，且泛型参数T来自外部函数的泛型声明，会抛出java.lang.IllegalArgumentException: Unrecognized Type: [null]异常；但将该语句直接写在函数内部时则运行正常。

异常原因 #

这是Java泛型类型擦除和Lambda表达式的类型处理机制共同导致的：

• TypeReference的工作原理是通过匿名内部类的父类类型获取泛型参数信息，编译器会把泛型的实际类型嵌入到匿名内部类的字节码中。
• 当在Lambda表达式内部创建TypeReference<T>时，Lambda的动态生成特性会导致泛型参数T的实际类型信息被完全擦除，Jackson无法通过反射获取有效类型信息，因此抛出类型无法识别的异常。
• 而直接在函数内部创建TypeReference<T>时，编译器会保留足够的类型签名信息，Jackson可以正常读取到泛型的实际类型。

解决方案 #

方案1：由调用方传入TypeReference实例 #

将TypeReference<T>作为参数传入目标方法，让调用方提供携带实际类型信息的类型引用，Lambda中直接使用该实例即可避免类型信息丢失。

修改后的完整代码：

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;

import java.util.ArrayList;
import java.util.List;
import java.util.Objects;
import java.util.function.Function;

public class Main {

    public static void main(String[] args) {
        String test = "[\"test\"]";
        // 调用时传入具体的TypeReference实例
        List<String> strings = getObjectConfig(test, new ArrayList<>(), new TypeReference<List<String>>() {});
        System.out.println(strings);
    }

    public static <T> T getObjectConfig(String key, T defaultValue, TypeReference<T> typeRef) {
        return getCommon(
                key,
                v -> {
                    if (Objects.isNull(v)) {
                        return defaultValue;
                    } else {
                        try {
                            // 直接使用传入的typeRef
                            return new ObjectMapper().readValue(v, typeRef);
                        } catch (JsonProcessingException e) {
                            throw new RuntimeException(e);
                        }
                    }
                }
        );
    }

    private static <T> T getCommon(String key, Function<String, T> transFunc) {
        try {
            String value = key;
            return transFunc.apply(value);
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }
}

方案2：使用Guava的TypeToken（可选） #

如果项目中引入了Guava库，可以用TypeToken替代Jackson的TypeReference，它的类型捕获机制更灵活，能在Lambda中正确保留泛型信息，但需要额外依赖Guava。

验证说明 #

修改后的代码可以正常反序列化JSON字符串为List<String>，不再抛出类型无法识别的异常，同时保留了原有代码的函数式调用结构。

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