hibernate/hibernate-orm · error · HibernateException

NoneBasicProxyFactory is unable to generate a BasicProxy for

Error message

NoneBasicProxyFactory is unable to generate a BasicProxy for type {superClassOrInterface}. Enable a different BytecodeProvider.

What it means

Error "NoneBasicProxyFactory is unable to generate a BasicProxy for type {superClassOrInterface}. Enable a different BytecodeProvider." thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/bytecode/internal/none/NoneBasicProxyFactory.java:23

package org.hibernate.bytecode.internal.none;

import org.hibernate.HibernateException;
import org.hibernate.bytecode.spi.BasicProxyFactory;

/**
 * This is used to instantiate "components" which are either Abstract or defined by an Interface.
 */
final class NoneBasicProxyFactory implements BasicProxyFactory {

	private final Class superClassOrInterface;

	public NoneBasicProxyFactory(Class superClassOrInterface) {
		this.superClassOrInterface = superClassOrInterface;
	}

	@Override
	public Object getProxy() {
		throw new HibernateException( "NoneBasicProxyFactory is unable to generate a BasicProxy for type " + superClassOrInterface + ". Enable a different BytecodeProvider." );
	}

}

View on GitHub (pinned to fad1729dce)

Solutions

1. Enable the ByteBuddy bytecode provider (default); the 'none' provider cannot generate proxies required by this model.

Example fix

Enable the ByteBuddy bytecode provider (default); the 'none' provider cannot generate proxies required by this model.

When it happens

Trigger: Bytecode enhancement, proxy creation, or lazy interception is applied to an incompatible class or configuration.

Common situations: Build-time enhancement with module-system restrictions, mismatched Hibernate versions between build and runtime, or hibernate.bytecode.provider=none with a model that needs proxies.

AI-assisted analysis of hibernate/hibernate-orm@fad1729dce (2026-08-22). Data as JSON: /api/errors/ac6013a0f2c0fb11. Report an issue: GitHub.