apache/dubbo · error · IllegalArgumentException

${cls.getName()} generic type undefined!

Error message

${cls.getName()} generic type undefined!

What it means

ReflectUtils.getGenericClassType attempts to extract the raw Class from a Type (handling GenericArrayType, array Class, and plain Class). If any Throwable is thrown during this extraction (class cast, null, resolution failure), it wraps the cause in an IllegalArgumentException stating the class name's generic type is undefined. This signals that the generic type parameter cannot be resolved to a concrete class.

Source

Thrown at dubbo-common/src/main/java/org/apache/dubbo/common/utils/ReflectUtils.java:294

            Object genericClass = parameterizedType.getActualTypeArguments()[i];

            // handle nested generic type
            if (genericClass instanceof ParameterizedType) {
                return (Class<?>) ((ParameterizedType) genericClass).getRawType();
            }

            // handle array generic type
            if (genericClass instanceof GenericArrayType) {
                return (Class<?>) ((GenericArrayType) genericClass).getGenericComponentType();
            }

            // Requires JDK 7 or higher, Foo<int[]> is no longer GenericArrayType
            if (((Class) genericClass).isArray()) {
                return ((Class) genericClass).getComponentType();
            }
            return (Class<?>) genericClass;
        } catch (Throwable e) {
            throw new IllegalArgumentException(cls.getName() + " generic type undefined!", e);
        }
    }

    /**
     * get method name.
     * "void do(int)", "void do()", "int do(java.lang.String,boolean)"
     *
     * @param m method.
     * @return name.
     */
    public static String getName(final Method m) {
        StringBuilder ret = new StringBuilder();
        ret.append(getName(m.getReturnType())).append(' ');
        ret.append(m.getName()).append('(');
        Class<?>[] parameterTypes = m.getParameterTypes();
        for (int i = 0; i < parameterTypes.length; i++) {
            if (i > 0) {
                ret.append(',');

View on GitHub (pinned to 3a3043227f)

Solutions

1. Specify concrete generic types in the service interface instead of raw types (e.g. 'List<String>' not 'List').
2. If using TypeVariables, ensure they have concrete bounds or are resolved at the call site.
3. Check the wrapped cause in the exception — it reveals the specific extraction failure.
4. For collections of POJOs in generic RPC, define explicit concrete types rather than relying on runtime resolution.

Example fix

// before
public interface MyService {
    List getData(); // raw type
}
// after
public interface MyService {
    List<String> getData();
}

// Validate generic type is resolvable before processing
Type genericType = field.getGenericType();
if (genericType instanceof TypeVariable || genericType instanceof WildcardType) {
    throw new IllegalStateException(
        "Field " + field.getName() + " has unresolved generic type: "
        + genericType + ". Specify concrete type parameters.");
}

try {
    return ReflectUtils.getGenericClassType(cls);
} catch (IllegalArgumentException e) {
    logger.warn("Cannot resolve generic type for {}, using raw type", cls.getName());
    return Object.class; // fallback
}

When it happens

Trigger: Calling getGenericClassType on a class whose generic type information is incomplete or erases to an unresolvable form — e.g. a raw-typed collection, a TypeVariable with no bound, or a class loaded without generic signature info (legacy bytecode). The try-catch catches Throwable, so even ClassCastExceptions from unsafe casts trigger it.

Common situations: A Dubbo service interface that uses raw types (e.g. 'List' without '<>') or complex nested generics where the type erasure prevents resolution. Also when the class was compiled by an old or non-standard compiler that strips generic signatures, or when a TypeVariable without a concrete bound is encountered in a provider/consumer interface.

Related errors

• Unrecognized Type: ${fieldType.toString()}
• unable to determine bean class from factory's superclass or
• [ServiceDefinitionBuilder] Collection type [{0}] with unexpe
• Can not merge result because missing method [ {merger} ] in
• Can not merge result: {e.getMessage()}

AI-assisted analysis of apache/dubbo@3a3043227f (2026-08-14). Data as JSON: /api/errors/8611dd1c5675dd36. Report an issue: GitHub.