Spring Batch作业在Dev环境无法启动，报MySQL外部插件合规性错误

异常原因 #

数据库副本数不是直接诱因。报错的核心原因是Dev环境的MySQL集群启用了Group Replication（或类似的多节点同步插件），这类插件强制要求所有业务表必须定义主键；而Spring Batch 2.7.9默认生成的BATCH_JOB_EXECUTION_PARAMS表没有主键，触发了插件的校验规则，导致插入操作失败。

本地单实例MySQL未启用这类集群插件，因此不强制主键要求，作业可以正常运行。

解决步骤 #

1. 给缺失主键的Spring Batch表补全主键
   针对报错的BATCH_JOB_EXECUTION_PARAMS表，执行以下SQL添加联合主键（该表的JOB_EXECUTION_ID、KEY_NAME、TYPE_CD组合天然唯一）：

   ALTER TABLE BATCH_JOB_EXECUTION_PARAMS
   ADD PRIMARY KEY (JOB_EXECUTION_ID, KEY_NAME, TYPE_CD);
   

2. 检查并修复其他无主键的Spring Batch表
   Spring Batch默认生成的部分表（如BATCH_STEP_EXECUTION_CONTEXT、BATCH_JOB_EXECUTION_CONTEXT）也没有主键，同样需要补全，避免后续操作报错：

   • 给BATCH_STEP_EXECUTION_CONTEXT加主键：

     ALTER TABLE BATCH_STEP_EXECUTION_CONTEXT
     ADD PRIMARY KEY (STEP_EXECUTION_ID);
     

   • 给BATCH_JOB_EXECUTION_CONTEXT加主键：

     ALTER TABLE BATCH_JOB_EXECUTION_CONTEXT
     ADD PRIMARY KEY (JOB_EXECUTION_ID);
     

3. 自定义Spring Batch初始化SQL（可选）
   如果依赖Spring Batch自动建表（通过spring.batch.jdbc.initialize-schema配置），可以自定义建表SQL文件，替换默认的初始化脚本，确保所有表在创建时就包含主键，避免重复手动修改。

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