Spring Data原生查询PostgreSQL时如何为时区参数添加单引号

问题原因 #

Spring Data绑定int类型参数到原生SQL时，会直接输出数值，而PostgreSQL的INTERVAL语法要求其后跟随带单引号的字符串常量，因此导致语法错误。直接在:timeZoneOffset外添加单引号会被Spring视为字符串常量，不会触发参数替换，因此无效。

解决方案 #

方案1：使用PostgreSQL内置函数构造间隔（推荐）

改用PostgreSQL的make_interval函数直接通过数值构造间隔，无需手动拼接单引号，参数保持int类型即可：

@Query(value = """ SELECT utb.user_id, (MIN(utb.submitted_date) AT TIME ZONE make_interval(mins => :timeZoneOffset)) AS dateCheck
                               FROM user_table utb WHERE utb.user_id = :userId """, nativeQuery = true)
public List<TimeLog> findAllByUserWithTimezone(
            @Param("timeZoneOffset") int timeZoneOffset,
            @Param("userId") String userId);

• 说明：make_interval支持指定单位（hours/mins/secs等），根据你的实际偏移单位调整即可（示例中假设100是分钟偏移）。

方案2：将参数类型改为String

把timeZoneOffset的类型改为String，传入时直接传递对应字符串（如"100"或"2 hours"），Spring Data会自动为字符串参数添加单引号：

@Query(value = """ SELECT utb.user_id, (MIN(utb.submitted_date) AT TIME ZONE INTERVAL :timeZoneOffset) AS dateCheck
                               FROM user_table utb WHERE utb.user_id = :userId """, nativeQuery = true)
public List<TimeLog> findAllByUserWithTimezone(
            @Param("timeZoneOffset") String timeZoneOffset,
            @Param("userId") String userId);

• 调用示例：传入参数"100"，生成的SQL会自动处理为INTERVAL '100'。

方案3：使用SpEL表达式直接插入参数（注意SQL注入风险）

如果必须保持int参数类型，可通过SpEL表达式将参数值直接拼接进SQL，但此方式不使用预编译参数，存在SQL注入风险，仅适用于参数完全可信的场景：

@Query(value = """ SELECT utb.user_id, (MIN(utb.submitted_date) AT TIME ZONE INTERVAL '#{#timeZoneOffset}') AS dateCheck
                               FROM user_table utb WHERE utb.user_id = :userId """, nativeQuery = true)
public List<TimeLog> findAllByUserWithTimezone(
            @Param("timeZoneOffset") int timeZoneOffset,
            @Param("userId") String userId);

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