{"record":{"id":"64a4f49a3da1b25d","repo":"hibernate/hibernate-orm","slug":"cannot-unwrap-to-requested-type-64a4f4","errorCode":null,"errorMessage":"Cannot unwrap to requested type [{}]","messagePattern":"Cannot unwrap to requested type \\[(.+?)\\]","errorType":"exception","errorClass":"UnknownUnwrapTypeException","httpStatus":null,"severity":"error","filePath":"hibernate-core/src/main/java/org/hibernate/engine/jdbc/connections/internal/UserSuppliedConnectionProviderImpl.java","lineNumber":34,"sourceCode":" * exception when a connection is requested, the assumption being that the application\n * is responsible for handing the connection to use to the session.\n *\n * @author Gavin King\n * @author Steve Ebersole\n */\npublic class UserSuppliedConnectionProviderImpl implements ConnectionProvider {\n\t@Override\n\tpublic boolean isUnwrappableAs(@Nonnull Class<?> unwrapType) {\n\t\treturn unwrapType.isAssignableFrom( UserSuppliedConnectionProviderImpl.class );\n\t}\n\n\t@Override\n\tpublic <T> T unwrap(@Nonnull Class<T> unwrapType) {\n\t\tif ( unwrapType.isAssignableFrom( UserSuppliedConnectionProviderImpl.class ) ) {\n\t\t\treturn unwrapType.cast( this );\n\t\t}\n\t\telse {\n\t\t\tthrow new UnknownUnwrapTypeException( unwrapType );\n\t\t}\n\t}\n\n\t@Override\n\tpublic Connection getConnection() throws SQLException {\n\t\tthrow new UnsupportedOperationException( \"The application must supply JDBC connections\" );\n\t}\n\n\t@Override\n\tpublic void closeConnection(Connection connection) throws SQLException {\n\t\tthrow new UnsupportedOperationException( \"The application must supply JDBC connections\" );\n\t}\n\n\t@Override\n\tpublic boolean supportsAggressiveRelease() {\n\t\treturn false;\n\t}\n}","sourceCodeStart":16,"sourceCodeEnd":52,"githubUrl":"https://github.com/hibernate/hibernate-orm/blob/fad1729dce015f908198d57a8d80274a30f905a5/hibernate-core/src/main/java/org/hibernate/engine/jdbc/connections/internal/UserSuppliedConnectionProviderImpl.java#L16-L52","documentation":"Error \"Cannot unwrap to requested type [{}]\" thrown in hibernate/hibernate-orm.","triggerScenarios":"Thrown at hibernate-core/src/main/java/org/hibernate/engine/jdbc/connections/internal/UserSuppliedConnectionProviderImpl.java:34 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Only unwrap to interfaces implemented by UserSuppliedConnectionProviderImpl","Avoid unwrap() to unrelated types"],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"fad1729dce015f908198d57a8d80274a30f905a5","analyzedAt":"2026-08-22T04:13:57.527Z","schemaVersion":2},"datasetVersion":"2026-08-22T09:17:25.309Z"}