使用 spring-boot 和 bitronix JTA 管理器将 XA 数据源配置到 mysql 8 DB 失败，并出现 SqlException XAERR_RMERR

Question

我创建了一个 Spring Boot 2 (2.1.6.RELEASE) 项目，该项目依赖于 spring-boot-starter-data-jpa 和 spring spring-boot-starter-jta-bitronix，并为 Mysql DB (8.0.16 ）。

应用程序属性文件（根据 <> 之间的占位符值的相关性进行修剪）包含以下配置：

spring:
  datasource:
    url: jdbc:mysql://<host>:<port>/<dbName>
    username: <username>
    password: <password>
    driver-class-name: com.mysql.cj.jdbc.Driver
  jpa:
    database-platform: org.hibernate.dialect.MySQL8Dialect
    hibernate:
      ddl-auto: none
  jta:
    bitronix:
      properties:
        server-id: <serverid>

在启动 Spring Boot 应用程序时，我收到以下错误堆栈跟踪：

org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'entityManagerFactory' defined in class path resource [org/springframework/boot/autoconfigure/orm/jpa/HibernateJpaConfiguration.class]: Unsatisfied dependency expressed through method 'entityManagerFactory' parameter 0; nested exception is org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'entityManagerFactoryBuilder' defined in class path resource [org/springframework/boot/autoconfigure/orm/jpa/HibernateJpaConfiguration.class]: Unsatisfied dependency expressed through method 'entityManagerFactoryBuilder' parameter 0; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'jpaVendorAdapter' defined in class path resource [org/springframework/boot/autoconfigure/orm/jpa/HibernateJpaConfiguration.class]: Bean instantiation via factory method failed; nested exception is org.springframework.beans.BeanInstantiationException: Failed to instantiate [org.springframework.orm.jpa.JpaVendorAdapter]: Factory method 'jpaVendorAdapter' threw exception; nested exception is bitronix.tm.resource.ResourceConfigurationException: cannot create JDBC datasource named dataSource
Caused by: org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'entityManagerFactoryBuilder' defined in class path resource [org/springframework/boot/autoconfigure/orm/jpa/HibernateJpaConfiguration.class]: Unsatisfied dependency expressed through method 'entityManagerFactoryBuilder' parameter 0; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'jpaVendorAdapter' defined in class path resource [org/springframework/boot/autoconfigure/orm/jpa/HibernateJpaConfiguration.class]: Bean instantiation via factory method failed; nested exception is org.springframework.beans.BeanInstantiationException: Failed to instantiate [org.springframework.orm.jpa.JpaVendorAdapter]: Factory method 'jpaVendorAdapter' threw exception; nested exception is bitronix.tm.resource.ResourceConfigurationException: cannot create JDBC datasource named dataSource
Caused by: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'jpaVendorAdapter' defined in class path resource [org/springframework/boot/autoconfigure/orm/jpa/HibernateJpaConfiguration.class]: Bean instantiation via factory method failed; nested exception is org.springframework.beans.BeanInstantiationException: Failed to instantiate [org.springframework.orm.jpa.JpaVendorAdapter]: Factory method 'jpaVendorAdapter' threw exception; nested exception is bitronix.tm.resource.ResourceConfigurationException: cannot create JDBC datasource named dataSource
Caused by: org.springframework.beans.BeanInstantiationException: Failed to instantiate [org.springframework.orm.jpa.JpaVendorAdapter]: Factory method 'jpaVendorAdapter' threw exception; nested exception is bitronix.tm.resource.ResourceConfigurationException: cannot create JDBC datasource named dataSource
Caused by: bitronix.tm.resource.ResourceConfigurationException: cannot create JDBC datasource named dataSource
Caused by: bitronix.tm.recovery.RecoveryException: failed recovering resource dataSource
Caused by: com.mysql.cj.jdbc.MysqlXAException: XAER_RMERR: Fatal error occurred in the transaction branch - check your data for consistency
Caused by: java.sql.SQLException: XAER_RMERR: Fatal error occurred in the transaction branch - check your data for consistency

Answer 1

免责声明：我正在自我记录我自己的问题，希望能帮助其他人，因为令人惊讶的是，这个问题/问题很难解决。

通过在 github https://github.com/bitronix/btm/issues/100上验证 bitronix 问题跟踪器，即使问题已经在没有直接答案的情况下关闭，解决方案也不是很明显。

阅读https://github.com/bitronix/btm/wiki/FAQ上的 bitronix FAQ给出了有关该问题的提示，尽管该问题与 Oracle 相关，涉及缺少用户权限。

进一步调查导致了有关权限的 MySQL 8 文档页面https://dev.mysql.com/doc/refman/8.0/en/privileges-provided.html，其中特别强调了以下部分。

在 MySQL 8.0 之前，任何用户都可以执行 XA RECOVER 语句来发现未完成的准备好的 XA 事务的 XID 值，这可能会导致 XA 事务由启动该事务的用户以外的用户提交或回滚。在 MySQL 8.0 中，仅允许具有 XA_RECOVER_ADMIN 权限的用户执行 XA RECOVER，而该权限预计仅授予需要该权限的管理用户。例如，对于 XA 应用程序的管理员来说，如果该应用程序崩溃了，并且有必要找到由该应用程序启动的未完成事务，以便可以回滚它们，则可能会出现这种情况。此权限要求可防止用户发现除自己以外的未完成准备的 XA 事务的 XID 值。它不会影响XA事务的正常提交或回滚，因为启动它的用户知道它的XID。

因此，我通过 MySQL 中的以下命令为数据源用户添加了所需的权限（根据需要替换用户名和主机部分）。

GRANT XA_RECOVER_ADMIN ON *.* TO 'username'@'%';
FLUSH PRIVILEGES;

通过此更改，Spring Boot 应用程序启动时不会出现任何问题。