JdbcBatchItemWriter中JdbcTemplate移除INSERT语句的timestamp列问题

我们使用Spring Batch进行数据库间的记录同步，目标表定义如下：

CREATE TABLE entity_name (
    entity_id varchar(255) NOT NULL,
    value varchar(255) NOT NULL,
    source varchar(255) NULL,
    type enum('type1', 'type2','type3') NULL,
    timestamp timestamp NULL,
    status varchar(50) DEFAULT 'approved',
    CONSTRAINT entity_name_pkey PRIMARY KEY (entity_id, value)
);

实例化Writer的代码如下：

String command = "insert into entity_name(entity_id, value, source, type, status, timestamp) values(:entityId, :value, :source, :type, :status, :timestamp)";

JdbcBatchItemWriter<EntityName> entityWriter = new DefaultItemWriter<EntityName>(dataSource, jdbcTemplate, command, excludedTypes).getWriter();

但从JdbcBatchItemWriter的调试日志来看，语句中的timestamp列被移除：

08:48:16.528 [main] DEBUG org.springframework.batch.item.database.JdbcBatchItemWriter - Executing batch with 2 items.
08:48:16.529 [main] DEBUG org.springframework.jdbc.core.JdbcTemplate - Executing SQL batch update [insert into entity_name(entity_id, value, source, type, status ) values(?, ?, ?, ?, ?)]

已知timestamp是SQL保留字，但当前无法修改表结构，想了解此是否为JdbcTemplate的预期行为，以及是否有解决办法。

1. 是否为JdbcTemplate的预期行为？ #

这不是JdbcTemplate的直接预期行为，问题根源在于Spring Batch的JdbcBatchItemWriter配合命名参数解析时，timestamp作为SQL保留字，默认的参数处理器可能将其识别为特殊关键字过滤，或是在参数绑定阶段出现冲突，最终导致该列从SQL语句中被移除。

2. 解决办法 #

方法一：用数据库特定转义符包裹保留字 #

针对不同数据库的转义规则修改SQL语句，确保保留字被正确识别：

• MySQL/MariaDB：使用反引号包裹

insert into entity_name(entity_id, value, source, type, status, `timestamp`) values(:entityId, :value, :source, :type, :status, :timestamp)

• PostgreSQL/Oracle：使用双引号包裹（Oracle需注意列名大小写匹配）

insert into entity_name(entity_id, value, source, type, status, "timestamp") values(:entityId, :value, :source, :type, :status, :timestamp)

方法二：检查自定义DefaultItemWriter的过滤逻辑 #

你使用的DefaultItemWriter是自定义封装类，需确认其内部是否存在SQL语句过滤逻辑（比如excludedTypes参数是否包含对timestamp的排除规则）。如果是自定义过滤导致的列被移除，调整过滤规则允许timestamp列保留即可。

方法三：自定义命名参数解析器 #

如果默认的NamedParameterJdbcTemplate解析逻辑存在问题，可以自定义参数解析逻辑，确保timestamp参数被正确绑定。不过这种方式复杂度较高，优先推荐前两种方法。

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