Spring Batch自动生成表与MySQL大小写敏感问题解决方案咨询

问题本质 #

Spring Batch默认使用全大写表名（如BATCH_JOB_INSTANCE），Windows下MySQL不区分表名大小写所以能正常运行，但Linux/Mac等Unix类系统中MySQL区分大小写，导致找不到手动创建的小写表，或者自动生成的大写表和预期不符。

代码层面解决方案 #

方案一：自定义Batch配置，强制使用小写表名前缀 #

通过实现DefaultBatchConfigurer重写JobRepository的创建逻辑，指定小写的表名前缀，让Spring Batch全程使用小写表名：

import org.springframework.batch.core.configuration.annotation.DefaultBatchConfigurer;
import org.springframework.batch.core.repository.JobRepository;
import org.springframework.batch.core.repository.support.JobRepositoryFactoryBean;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Configuration;
import javax.sql.DataSource;

@Configuration
public class CustomBatchConfigurer extends DefaultBatchConfigurer {

    private final DataSource dataSource;

    @Autowired
    public CustomBatchConfigurer(DataSource dataSource) {
        this.dataSource = dataSource;
    }

    @Override
    protected JobRepository createJobRepository() throws Exception {
        JobRepositoryFactoryBean factory = new JobRepositoryFactoryBean();
        factory.setDataSource(dataSource);
        // 指定小写表名前缀，Spring Batch会自动拼接成batch_job_instance等小写表名
        factory.setTablePrefix("batch_");
        factory.setTransactionManager(getTransactionManager());
        factory.afterPropertiesSet();
        return factory.getObject();
    }
}

配置后，不管是自动生成表还是手动创建表，都统一使用batch_job_instance、batch_job_execution这类小写命名，彻底消除跨平台大小写差异问题。

方案二：自定义初始化脚本，使用小写表名 #

如果需要保留自动初始化表的逻辑，可以自定义MySQL初始化脚本，将表名全部改为小写，然后通过配置指定使用该脚本：

1. 在src/main/resources下创建custom-batch-schema-mysql.sql，内容示例（所有表名小写）：

CREATE TABLE IF NOT EXISTS batch_job_instance (
    job_instance_id BIGINT NOT NULL PRIMARY KEY AUTO_INCREMENT,
    version BIGINT,
    job_name VARCHAR(100) NOT NULL,
    job_key VARCHAR(32) NOT NULL,
    CONSTRAINT job_inst_un UNIQUE (job_name, job_key)
) ENGINE=InnoDB;

CREATE TABLE IF NOT EXISTS batch_job_execution (
    job_execution_id BIGINT NOT NULL PRIMARY KEY AUTO_INCREMENT,
    version BIGINT,
    job_instance_id BIGINT NOT NULL,
    create_time DATETIME NOT NULL,
    start_time DATETIME DEFAULT NULL,
    end_time DATETIME DEFAULT NULL,
    status VARCHAR(10),
    exit_code VARCHAR(2500),
    exit_message VARCHAR(2500),
    last_updated DATETIME,
    job_configuration_location VARCHAR(2500) NULL,
    CONSTRAINT job_exec_inst_fk FOREIGN KEY (job_instance_id)
        REFERENCES batch_job_instance(job_instance_id)
) ENGINE=InnoDB;

-- 其他Spring Batch所需表按此格式补充，全部使用小写表名

2. 在application.properties中配置使用自定义脚本：

spring.batch.jdbc.initialize-schema=ALWAYS
spring.batch.jdbc.schema=classpath:custom-batch-schema-mysql.sql

注意事项 #

• 不要依赖修改MySQL的lower_case_table_names参数（虽然能解决问题，但属于环境配置，无法保证所有部署环境都能修改该参数），代码层面的方案更可控。
• 如果已经手动创建了小写表，使用方案一后不需要修改表结构，Spring Batch会自动匹配小写表名。

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