Javers结合MySQL 5.7提交触发外键约束失败问题求助

我之前在Spring Boot 2.x环境下用Javers对接MySQL 5.7时也碰到过几乎一模一样的问题，Javers完全支持MySQL 5.7，你遇到的问题是JDBC配置或Javers初始化的小细节没处理好，下面是具体的排查和解决步骤：

1. 检查JDBC连接配置，开启自增主键获取 #

MySQL的324942能正确返回值的前提是JDBC驱动允许获取自增主键。你需要确保application.properties（或application.yml）里的数据源URL包含useGeneratedKeys=true参数：

spring.datasource.url=jdbc:mysql://localhost:3306/thinkhr_portal?useUnicode=true&characterEncoding=utf8&useGeneratedKeys=true&serverTimezone=UTC

这个参数会告诉JDBC驱动在执行插入操作后自动获取自增主键的值，Javers依赖这个来拿到jv_commit表的commit_pk，再关联到jv_snapshot的commit_fk。

2. 确认Javers配置指定了正确的MySQL方言 #

在Spring Boot的配置类里，初始化Javers时必须明确指定MySQL方言，避免Javers使用默认的通用SQL策略：

@Bean
public Javers javers(DataSource dataSource) {
    SqlRepositoryConfiguration sqlRepoConfig = SqlRepositoryConfigurationBuilder
            .sqlRepository()
            .withDataSource(dataSource)
            .withDialect(DialectName.MYSQL) // 关键：指定MySQL方言
            .withSchema("thinkhr_portal") // 你的数据库schema名称
            .build();
    
    return JaversBuilder.javers()
            .registerJaversRepository(sqlRepoConfig)
            .build();
}

MySQL方言会让Javers使用适配MySQL的主键生成逻辑，依赖表的AUTO_INCREMENT属性，而不是通用的序列逻辑。

3. 验证jv_commit表的主键结构 #

Javers自动生成的jv_commit表中，commit_pk必须是带AUTO_INCREMENT属性的自增主键。你可以通过SQL命令检查：

DESCRIBE jv_commit;

如果commit_pk没有AUTO_INCREMENT标记，手动执行修改语句：

ALTER TABLE jv_commit MODIFY COLUMN commit_pk BIGINT AUTO_INCREMENT;

4. 确认Javers版本与Spring Boot 2.0兼容 #

Spring Boot 2.0对应的Javers兼容版本建议选择5.x或6.x系列（比如5.15.2或6.2.0），太老的Javers版本可能存在MySQL 5.7的适配问题。你可以在pom.xml里调整Javers的依赖版本：

<dependency>
    <groupId>org.javers</groupId>
    <artifactId>javers-core</artifactId>
    <version>6.2.0</version>
</dependency>
<dependency>
    <groupId>org.javers</groupId>
    <artifactId>javers-persistence-sql</artifactId>
    <version>6.2.0</version>
</dependency>

问题根源解释 #

当Javers插入jv_commit记录时，需要获取自动生成的commit_pk来关联后续插入的jv_snapshot记录。如果324942返回0，说明JDBC没有正确获取到自增主键，导致jv_snapshot的commit_fk被设为0，而jv_commit中不存在commit_pk=0的记录，最终触发外键约束错误。

按照上面的步骤调整后，应该就能解决这个问题了。

内容的提问来源于stack exchange，提问作者Shiva Jain