本文详解 Spring Boot 集成 H2 数据库时因 identity 关键字不兼容导致的 JdbcSQLSyntaxErrorException，提供符合 H2 2.0+ 规范的建表语句修正方案，并附完整配置建议与最佳实践。
本文详解 spring boot 集成 h2 数据库时因 `identity` 关键字不兼容导致的 `jdbcsqlsyntaxerrorexception`，提供符合 h2 2.0+ 规范的建表语句修正方案，并附完整配置建议与最佳实践。
在 Spring Boot 项目中使用 H2 内存数据库进行快速开发或单元测试时，常通过 schema.sql 自动初始化表结构。但自 H2 2.0 版本起（Spring Boot 2.5+ 默认集成 H2 2.1.x），其 SQL 语法已严格遵循标准 SQL，不再支持旧版 H2 中 integer identity NOT NULL 这类非标准写法——该语法在 H2 1.4.x 中可运行，但在新版中会直接抛出 Syntax error in SQL statement，错误位置明确指向 [*]identity，提示期望的是 AUTO_INCREMENT、GENERATED 或 AS IDENTITY 等标准子句。
✅ 正确的 H2 兼容建表语句（推荐）
H2 2.0+ 推荐使用 GENERATED BY DEFAULT AS IDENTITY（符合 SQL:2008 标准），这是最清晰、可移植性最强的写法：
-- schema.sql
CREATE TABLE course (
course_id INTEGER GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
title VARCHAR(80) NOT NULL,
description VARCHAR(500) NOT NULL,
link VARCHAR(255) NOT NULL
);⚠️ 注意：无需再显式声明 CONSTRAINT pk_course_course_id PRIMARY KEY (course_id) —— PRIMARY KEY 已隐含唯一约束与主键约束，冗余定义反而可能引发解析歧义。
? 其他等效写法（按场景选择）
| 写法 | 说明 | 适用场景 |
|---|---|---|
| course_id BIGINT AUTO_INCREMENT PRIMARY KEY | H2 支持 MySQL 风格别名（需启用兼容模式） | 仅当 spring.h2.console.settings.web-allow-others=true 且明确需要 MySQL 兼容时 |
| course_id INTEGER NOT NULL, CONSTRAINT pk_course PRIMARY KEY (course_id) + ALTER TABLE course ALTER COLUMN course_id RESTART WITH 1 | 分离定义与序列初始化 | 复杂初始化逻辑，但不推荐用于简单场景 |
?️ 配置检查清单（避免常见陷阱）
确保以下配置项正确，防止自动初始化失败：
- ✅ src/main/resources/application.properties 中禁用 Hibernate 自动建表（避免与 schema.sql 冲突）：
spring.jpa.hibernate.ddl-auto=none
- ✅ 显式启用 SQL 脚本初始化（Spring Boot 2.5+ 默认启用，但仍建议显式声明）：
spring.sql.init.mode=always spring.sql.init.schema-locations=classpath:schema.sql spring.sql.init.data-locations=classpath:data.sql # 如需初始数据
- ✅ 确认 schema.sql 文件编码为 UTF-8，无 BOM 头（尤其 Windows 下复制代码易引入不可见字符）。
? 补充说明：为什么原语句报错？
原始语句 course_id integer identity NOT NULL 是 H2 1.4 的专有语法，而 H2 2.x 已移除该简写，要求显式使用 GENERATED ... AS IDENTITY。错误信息中 expected "AUTO_INCREMENT, GENERATED, ..." 正是 H2 解析器给出的明确语法提示——它不是“不支持自增”，而是“请用标准方式声明”。
✅ 最终验证步骤
- 替换 schema.sql 为上述推荐语句；
- 清理构建缓存：./mvnw clean（Maven）或 ./gradlew clean（Gradle）；
- 重启应用，观察控制台日志中是否出现：
HikariPool-1 - Starting... Executing SQL script from class path resource [schema.sql]
若仍报错，请检查 schema.sql 是否被多个模块重复加载（如测试资源目录误含同名文件），或通过 spring.sql.init.continue-on-error=true 定位具体哪一行失败。
掌握 H2 新版 SQL 语法规范，不仅能解决当前问题，更能提升多数据库迁移能力——因为 GENERATED BY DEFAULT AS IDENTITY 同样被 PostgreSQL、SQL Server 2012+ 和 DB2 原生支持，是现代 Java 持久层开发的通用基石。
