Spring Boot Batch 2.0.2对接MySQL主键始终为0问题求助

看起来你遇到了Spring Boot Batch从1.5.x升级到2.0.2后和MySQL适配的典型问题，这两个版本在Batch元数据初始化和主键策略上有不少变化，咱们一步步来解决：

一、解决元数据表主键重复（Duplicate entry '0'）的问题 #

这个问题的核心是Spring Boot Batch 2.0.x默认的元数据主键生成策略不兼容MySQL。在1.5.x版本中，Batch会自动适配MySQL的自增主键，但2.0之后默认使用通用的表生成策略（TABLE），而MySQL需要用IDENTITY自增逻辑。你可以通过以下两种方式解决：

方式1：指定MySQL专用的初始化Schema #

Spring Batch提供了针对不同数据库的schema脚本，你需要在application.properties中明确指定MySQL的schema文件：

# 仅当表不存在时初始化Batch元数据（适合生产环境，避免覆盖已有数据）
spring.batch.initialize-schema=if-not-exists
# 指定MySQL专属的元数据schema脚本路径
spring.batch.schema=classpath:org/springframework/batch/core/schema-mysql.sql

这个官方脚本已经给所有元数据表（比如BATCH_JOB_INSTANCE、BATCH_STEP_EXECUTION等）的主键设置了AUTO_INCREMENT属性，完全适配MySQL的自增规则，能从根源上避免主键生成0的问题。

方式2：手动配置Batch的主键生成策略 #

如果不想依赖官方schema脚本，你可以在配置类中指定Batch使用MySQL的自增序列：

@Configuration
public class BatchCustomConfig {

    @Bean
    public DataFieldMaxValueIncrementer jobSequenceIncrementer(DataSource dataSource) {
        return new MySQLMaxValueIncrementer(dataSource, "BATCH_JOB_SEQ");
    }

    @Bean
    public DataFieldMaxValueIncrementer stepSequenceIncrementer(DataSource dataSource) {
        return new MySQLMaxValueIncrementer(dataSource, "BATCH_STEP_SEQ");
    }
}

这样Batch会直接调用MySQL的自增逻辑生成主键，不会再出现统一生成0值的情况。

二、解决新建数据库后无法创建表的问题 #

你提到设置spring.jpa.hibernate.ddl-auto无效，这是正常的：Spring Batch的元数据表不由JPA管理，它有独立的表初始化机制。需要分两种场景处理：

1. Batch元数据表的创建 #

必须配置Spring Batch专属的初始化属性，可选值：

• always：每次启动都重新初始化schema（适合开发环境，方便调试）
• if-not-exists：仅当表不存在时创建（适合生产环境，保护已有数据）
• never：完全不自动初始化（需要手动执行schema脚本）
  配合前面的spring.batch.schema指定MySQL脚本，就能自动创建Batch的元数据表了。

2. 自定义业务表的创建 #

如果你的作业涉及自定义业务表（比如读写数据的表），且用JPA实体类定义，需要确认：

• 实体类添加了@Entity注解，@Table指定了正确的表名
• spring.jpa.hibernate.ddl-auto设置为create（开发环境）或update（生产环境）
• 数据源配置完全正确，确保Spring Boot能正常连接到MySQL数据库

三、额外检查点 #

• 确认MySQL驱动版本和Spring Boot 2.0.2兼容：2.0.x版本建议使用mysql-connector-java 5.1.x（驱动类com.mysql.jdbc.Driver）或8.0.x（驱动类com.mysql.cj.jdbc.Driver，需额外指定时区参数）
• 检查数据源配置是否完整：

spring.datasource.url=jdbc:mysql://localhost:3306/your_db?useSSL=false&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=your_password
spring.datasource.driver-class-name=com.mysql.jdbc.Driver # 8.0.x版本替换为com.mysql.cj.jdbc.Driver

• 自定义业务实体的主键要配置正确的自增策略，比如：

@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;

按照上面的步骤调整后，应该就能解决主键重复和表无法创建的问题了。

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