本文探讨了在Oracle数据库中使用`OFFSET`作为列名，并在H2数据库进行单元测试时遇到的兼容性问题。由于`OFFSET`是H2的保留关键词，即使通过JDBC URL设置`NON_KEYWORDS=OFFSET`，H2的SQL解析器在执行查询时仍可能将其识别为关键词，导致语法错误。文章详细分析了此现象的深层原因，并指出目前最可靠的解决方案是在查询中对冲突的列名进行双引号引用，以确保跨数据库的兼容性。
1. 问题背景：H2数据库中关键词列名的冲突
在多数据库环境中进行开发和测试时，一个常见的挑战是处理不同数据库系统之间对SQL关键词的定义差异。当一个列名在某个数据库中是合法的标识符，但在另一个数据库中却是保留关键词时，就会引发兼容性问题。
本教程聚焦于一个具体的案例：Oracle数据库中存在一个名为OFFSET的列，而H2数据库将其视为保留关键词。在Spring Framework的EmbeddedDatabaseBuilder构建H2嵌入式数据库进行单元测试时，直接引用offset列会导致org.h2.jdbc.JdbcSQLSyntaxErrorException。尽管尝试通过在H2连接URL中设置NON_KEYWORDS=OFFSET来解决此问题，但该设置在实际查询执行时并未生效。
2. 尝试的解决方案及其局限性
为了在H2中模拟Oracle环境并解决OFFSET列名冲突，通常会尝试以下方法：
2.1 使用 NON_KEYWORDS 参数
Spring的EmbeddedDatabaseBuilder允许在H2数据库名称中添加配置参数。一个直观的尝试是利用H2的NON_KEYWORDS设置，将OFFSET从关键词列表中移除，从而使其可以作为普通标识符使用。
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.jdbc.datasource.embedded.EmbeddedDatabase;
import org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseBuilder;
import org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseType;
import org.junit.Before;
import org.junit.After;
public class MyClassDaoTest {
private EmbeddedDatabase ds;
private MyClassDao myClassDao;
@Before
public void setup() {
this.ds = new EmbeddedDatabaseBuilder()
.setType( EmbeddedDatabaseType.H2 )
.setName( "dummy;MODE=Oracle;DATABASE_TO_UPPER=true;NON_KEYWORDS=OFFSET" ) // 尝试设置 NON_KEYWORDS
.addScript( "/initialize-mytbl.sql" )
.build();
this.myClassDao = new MyClassDao( new JdbcTemplate( this.ds ) );
}
@After
public void shutdown() {
this.ds.shutdown();
}
}配套的初始化脚本initialize-mytbl.sql如下，其中offset列被成功创建：
CREATE TABLE MYTBL ( offset INTEGER NOT NULL ); INSERT INTO MYTBL ( offset ) VALUES (1);
然而，当执行包含offset列的查询时，即使NON_KEYWORDS=OFFSET已设置，H2仍然抛出语法错误：
import org.springframework.jdbc.core.JdbcOperations;
public class MyClassDao {
private final JdbcOperations j;
public MyClassDao( JdbcOperations j ) { this.j = j; }
public int fetchOffset() {
// 此行在H2中会失败，但在Oracle中工作：
// return j.queryForObject( "select offset from mytbl", Integer.class );
// ...
}
}抛出的异常信息：
Caused by: org.h2.jdbc.JdbcSQLSyntaxErrorException: Syntax error in SQL statement "SELECT offset[*] from mytbl" ....
这表明NON_KEYWORDS设置在数据库实例化时可能有效（允许创建包含offset列的表），但在实际的SQL查询解析阶段，H2的解析器并未完全遵循此规则。
3. H2解析器行为分析
NON_KEYWORDS设置未能完全解决问题的原因在于H2数据库的SQL解析器机制。像H2和PostgreSQL这类数据库系统支持SQL标准中的OFFSET ... ROWS子句，用于分页操作。这意味着OFFSET在某些上下文语境中被解析为一个关键词，而不是一个列名标识符。
H2的解析器在处理SQL语句时，并不能总是“智能”地根据上下文（例如FROM子句的存在）来区分OFFSET是一个关键词（如分页操作的一部分）还是一个普通的列名。当它看到SELECT offset FROM mytbl时，它可能会优先将其解释为分页操作的开始，而不是一个列的引用，从而导致语法错误。
相比之下，Oracle数据库虽然也支持OFFSET/FETCH子句，但其解析器有不同的内部逻辑和启发式规则来区分OFFSET作为分页子句和作为标识符（例如在别名中SELECT * FROM TEST OFFSET）。这种解析行为的差异使得在H2中简单地通过NON_KEYWORDS来“禁用”关键词识别变得困难。
4. 推荐的解决方案：强制引用列名
鉴于H2解析器的局限性，目前最可靠且跨数据库兼容的解决方案是在SQL查询中对作为关键词的列名进行显式引用。在SQL标准中，双引号用于引用标识符，确保它们被解释为列名或表名，即使它们与关键词冲突。
修改后的查询代码如下：
import org.springframework.jdbc.core.JdbcOperations;
public class MyClassDao {
private final JdbcOperations j;
public MyClassDao( JdbcOperations j ) { this.j = j; }
public int fetchOffset() {
// 此行在H2和Oracle中均工作：
return j.queryForObject( "select \"OFFSET\" from mytbl", Integer.class );
}
}通过将offset修改为"OFFSET"，SQL解析器会明确地将其识别为一个标识符（列名），而不是一个保留关键词。这种方法在H2和Oracle中都能正常工作，因为它符合SQL标准，并且绕过了H2解析器对OFFSET关键词的歧义处理。
5. 注意事项与总结
- 强制引用是通用解法：当列名与目标数据库的保留关键词冲突时，使用双引号引用是解决此类问题的通用且最可靠的方法。虽然可能需要修改现有查询，但这是确保跨数据库兼容性的最佳实践。
- NON_KEYWORDS的局限性：尽管NON_KEYWORDS参数可以影响H2在某些上下文中的关键词识别（例如表创建），但它并非万能，尤其是在复杂的SQL解析场景中，其效果可能不如预期。
- 数据库版本影响：不同版本的H2和Oracle可能对SQL解析有细微差异。本文基于H2 2.1.x和Oracle 19.4版本。
- 设计建议：在数据库设计阶段，尽量避免使用与SQL标准或常用数据库系统保留关键词冲突的列名，可以从根本上规避此类问题。如果无法更改现有数据库结构，则强制引用是必要的应对策略。
综上所述，当在H2和Oracle等不同数据库系统之间处理包含关键词作为列名的情况时，即使尝试了NON_KEYWORDS等配置，由于SQL解析器的内在机制，最稳妥的解决方案仍然是在查询中显式地使用双引号引用这些冲突的列名。
