告别H2和SQLite：在Spring Boot项目里用Apache Derby做嵌入式数据库的完整配置流程
告别H2和SQLite：在Spring Boot项目里用Apache Derby做嵌入式数据库的完整配置流程
当开发者需要为Java应用选择轻量级数据库时，H2和SQLite往往是默认选项。但Apache Derby作为纯Java实现的嵌入式关系型数据库，在特定场景下可能更具优势。本文将深入探讨如何在Spring Boot项目中集成Derby，从选型对比到实战配置，提供可直接复用的代码片段和最佳实践。
1. 为什么选择Apache Derby？
在嵌入式数据库领域，Derby与H2、SQLite形成三足鼎立之势。但Derby有几个独特优势：
- 纯Java实现：与Spring Boot生态无缝集成，无需处理本地库依赖
- 完整SQL支持：严格遵循SQL标准，支持ACID事务和复杂查询
- 双模式部署：同一代码库可同时支持嵌入式和客户端/服务器模式
- 企业级特性：包括XA事务、存储过程和触发器支持
与H2相比，Derby在事务隔离级别控制上更精细；与SQLite相比，Derby的Java原生实现避免了JNI调用的性能损耗。下表对比了三者的关键差异：
| 特性 | Derby | H2 | SQLite |
|---|---|---|---|
| 实现语言 | Java | Java | C |
| 内存模式 | 支持 | 支持 | 不支持 |
| 全文搜索 | 需要扩展 | 内置 | 需要扩展 |
| 并发控制 | 行级锁 | 表级锁 | 文件锁 |
| JDBC驱动大小 | 3.5MB | 2MB | 1MB+JNI |
提示：当项目需要严格的事务一致性或在混合部署环境中使用时，Derby通常是更好的选择
2. Spring Boot集成配置
2.1 基础依赖配置
在pom.xml中添加Derby依赖：
<dependency> <groupId>org.apache.derby</groupId> <artifactId>derby</artifactId> <version>10.15.2.0</version> <scope>runtime</scope> </dependency>对于Spring Boot 2.7+，还需要显式配置数据库连接：
# application.yml spring: datasource: url: jdbc:derby:memory:testdb;create=true driver-class-name: org.apache.derby.jdbc.EmbeddedDriver username: sa password:2.2 数据库初始化策略
Derby支持多种初始化方式：
Schema SQL自动执行：
spring: sql: init: mode: always schema-locations: classpath:schema-derby.sql通过Java配置初始化：
@Bean public DataSourceInitializer dataSourceInitializer(DataSource dataSource) { DataSourceInitializer initializer = new DataSourceInitializer(); initializer.setDataSource(dataSource); initializer.setDatabasePopulator(new ResourceDatabasePopulator( new ClassPathResource("schema.sql"))); return initializer; }使用Flyway/Liquibase：
implementation 'org.flywaydb:flyway-core'
3. 开发环境实战技巧
3.1 使用ij工具交互查询
Derby自带的ij工具是强大的SQL交互终端。在Spring Boot测试中可这样使用：
@Test public void testDerbyConnection() throws SQLException { try (Connection conn = DriverManager.getConnection( "jdbc:derby:memory:testdb;create=true")) { Statement stmt = conn.createStatement(); stmt.execute("CREATE TABLE users (id INT PRIMARY KEY, name VARCHAR(50))"); // 验证表结构 DatabaseMetaData meta = conn.getMetaData(); ResultSet rs = meta.getTables(null, "APP", "USERS", null); assertTrue(rs.next()); } }3.2 测试配置优化
为测试环境专门配置application-test.yml：
spring: datasource: url: jdbc:derby:memory:testdb;create=true shutdown-url: jdbc:derby:memory:testdb;shutdown=true注意：Derby内存数据库需要显式调用shutdown才能完全释放资源
4. 生产环境注意事项
4.1 文件系统部署配置
持久化部署时应指定文件路径：
spring: datasource: url: jdbc:derby:/data/myapp/db;create=true目录结构建议：
/data/myapp/ ├── db/ # 数据库文件 ├── backups/ # 备份目录 └── logs/ # 日志文件4.2 连接池调优
结合HikariCP配置：
spring: datasource: hikari: maximum-pool-size: 10 idle-timeout: 30000 connection-timeout: 20004.3 备份与恢复方案
使用Derby工具实现热备份：
java -jar $DERBY_HOME/lib/derbyrun.jar sysinfo -cp $DERBY_HOME/lib/derbytools.jar java -jar $DERBY_HOME/lib/derbyrun.jar backup -d /data/myapp/db /backups/derby恢复时使用ij工具：
CALL SYSCS_UTIL.SYSCS_RESTORE_DATABASE('/backups/derby', '/data/myapp/db');5. 性能优化实战
5.1 索引策略优化
Derby的索引创建语法示例：
-- 单列索引 CREATE INDEX idx_username ON users(username); -- 复合索引 CREATE INDEX idx_name_dept ON employees(last_name, department_id); -- 函数索引 CREATE INDEX idx_upper_email ON customers(UPPER(email));5.2 内存参数调整
通过JVM参数优化Derby性能：
java -Dderby.storage.pageSize=8192 \ -Dderby.storage.pageCacheSize=10000 \ -jar myapp.jar关键参数说明：
| 参数 | 默认值 | 推荐值 | 作用 |
|---|---|---|---|
| derby.storage.pageSize | 4096 | 8192 | 增加I/O效率 |
| derby.storage.pageCacheSize | 1000 | 10000 | 提高缓存命中率 |
| derby.language.statementCacheSize | 50 | 200 | SQL语句缓存 |
5.3 批量操作优化
使用Derby的批量更新API提升性能：
try (Connection conn = dataSource.getConnection(); PreparedStatement pstmt = conn.prepareStatement( "INSERT INTO logs (timestamp, message) VALUES (?, ?)")) { conn.setAutoCommit(false); for (LogEntry entry : logEntries) { pstmt.setTimestamp(1, entry.getTimestamp()); pstmt.setString(2, entry.getMessage()); pstmt.addBatch(); if (i % 1000 == 0) { pstmt.executeBatch(); conn.commit(); } } pstmt.executeBatch(); conn.commit(); }6. 常见问题解决方案
6.1 类加载冲突
当出现ClassNotFoundException时，检查依赖冲突：
mvn dependency:tree | grep derby典型解决方案是排除冲突依赖：
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-jpa</artifactId> <exclusions> <exclusion> <groupId>org.hsqldb</groupId> <artifactId>hsqldb</artifactId> </exclusion> </exclusions> </dependency>6.2 数据库锁定问题
解决Derby数据库锁定：
查找锁定进程：
lsof | grep derby.log强制解锁：
java -jar $DERBY_HOME/lib/derbyrun.jar sysinfo -d jdbc:derby:/path/to/db
6.3 迁移现有数据
从H2迁移到Derby的步骤：
使用H2导出SQL：
SCRIPT TO 'backup.sql' COMPRESSION ZIP;修改SQL语法差异：
sed -i 's/IDENTITY/GENERATED ALWAYS AS IDENTITY/g' backup.sql在Derby中执行：
RUN 'backup.sql';
7. 监控与维护
7.1 内置监控工具
启用Derby监控：
spring: jmx: enabled: true通过JConsole连接后，可查看：
- 连接池状态
- 内存使用情况
- 活跃事务数
7.2 日志配置
调整Derby日志级别：
# log4j.properties log4j.logger.org.apache.derby=INFO log4j.logger.org.apache.derby.engine=WARN7.3 健康检查端点
自定义健康检查：
@Bean public HealthIndicator derbyHealthIndicator(DataSource dataSource) { return () -> { try (Connection conn = dataSource.getConnection()) { return Health.up() .withDetail("version", conn.getMetaData().getDatabaseProductVersion()) .build(); } }; }在实际项目中，Derby的表现往往超出预期。特别是在需要快速原型开发又要考虑未来扩展性的场景下，它的双模式设计让开发者在技术选型时拥有更多灵活性。