hibernate/hibernate-orm · error · HibernateException

Unable to parse object name: <text>

Error message

Unable to parse object name: <text>

What it means

Error "Unable to parse object name: <text>" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/boot/model/relational/QualifiedNameParser.java:139

		boolean schemaWasQuoted = false;
		boolean nameWasQuoted;

		final String[] tokens = StringHelper.split( ".", text );
		if ( tokens.length == 0 || tokens.length == 1 ) {
			// we have just a local name...
			name = text;
		}
		else if ( tokens.length == 2 ) {
			schemaName = tokens[0];
			name = tokens[1];
		}
		else if ( tokens.length == 3 ) {
			catalogName = tokens[0];
			schemaName = tokens[1];
			name = tokens[2];
		}
		else {
			throw new HibernateException( "Unable to parse object name: " + text );
		}

		nameWasQuoted = Identifier.isQuoted( name );
		if ( nameWasQuoted ) {
			name = unquote( name );
		}

		if ( schemaName != null ) {
			schemaWasQuoted = Identifier.isQuoted( schemaName );
			if ( schemaWasQuoted ) {
				schemaName = unquote( schemaName );
			}
		}
		else if ( defaultSchema != null ) {
			schemaName = defaultSchema.getText();
			schemaWasQuoted = defaultSchema.isQuoted();
		}

View on GitHub (pinned to fad1729dce)

Solutions

1. Fix the qualified name syntax (e.g. catalog.schema.object); quote parts containing dots or special characters.

Example fix

Fix the qualified name syntax (e.g. catalog.schema.object); quote parts containing dots or special characters.

When it happens

Trigger: An entity mapping annotation or bootstrap configuration violates a Hibernate mapping rule.

Common situations: Annotation mapping mistakes: inverse-side @Id associations, @Column on @OneToOne, unmapped association targets, mismatched @EnumeratedValue/@Temporal usage, duplicate sequence generators.

Understand the failure class

• Parsing and encoding errors: unexpected token, malformed input — why parsers reject input and how to find the real culprit.

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