H2数据库的.mv.db文件必须由H2引擎自身初始化，不可通过File.createNewFile()等Java I/O操作预先创建——否则将因缺失合法MVStore头结构导致IO Exception [90028-214]和EOFException错误。
h2数据库的`.mv.db`文件必须由h2引擎自身初始化，不可通过`file.createnewfile()`等java i/o操作预先创建——否则将因缺失合法mvstore头结构导致`io exception [90028-214]`和`eofexception`错误。
H2数据库采用MVStore（Multi-Version Store）存储引擎，其.mv.db文件并非普通二进制容器，而是一个具有严格格式的持久化结构：文件起始处包含魔数（magic number）、版本号、根块偏移、校验和等关键元数据。当您在代码中调用：
arquivo.createNewFile(); // ✅ 创建空文件
FileOutputStream fos = new FileOutputStream(arquivo);
fos.write("Este é o conteúdo do arquivo.".getBytes()); // ❌ 写入任意文本实际生成的是一个含随机字符串的空白文件，完全不具备MVStore所需的头部结构（如0x0A000000魔数、chunk header、page tree root等）。H2在启动时尝试读取第31字节附近的关键字段（见堆栈中readFully at 31），却遭遇EOFException——因为文件长度远小于最小有效MVStore文件（通常≥8KB），根本无法解析。
✅ 正确做法：交由H2自动建库
H2支持“首次连接即建库”机制，只需提供合法JDBC URL，无需预创建文件或目录：
String dbPath = "C:/Users/lopes/teste3"; // ⚠️ 不带 .mv.db 后缀！
String jdbcUrl = "jdbc:h2:file:" + dbPath + ";AUTO_SERVER=TRUE";
try (Connection conn = DriverManager.getConnection(jdbcUrl, "sa", "")) {
System.out.println("Database created and connected successfully!");
// 可选：执行建表语句
try (Statement stmt = conn.createStatement()) {
stmt.execute("CREATE TABLE IF NOT EXISTS users(id IDENTITY, name VARCHAR(255))");
}
} catch (SQLException e) {
e.printStackTrace();
}? 关键要点：
- URL中禁止添加 .mv.db 后缀：H2会自动追加，写成 jdbc:h2:file:C:/.../teste3.mv.db 将导致H2误认为这是旧版H2 1.4的*.h2.db文件，或触发冗余创建逻辑；
- 路径需可写且父目录存在：H2仅创建文件，不自动创建多级目录（mkdirs()仍需保留，但后续不手动写文件）；
- 推荐启用 AUTO_SERVER=TRUE：避免多进程/多线程并发访问时出现 Database may be already in use 错误；
- 首次连接后，.mv.db 文件即为合法H2数据库，可立即用H2 Console、DBeaver或DbVisualizer打开。
⚠️ 常见误区纠正：
- ❌ “先创建空文件再让H2写内容” → H2不会覆盖已有文件，而是报错或静默失败；
- ❌ “用记事本/代码写入SQL建库脚本” → .mv.db 是二进制存储，非SQL文本文件；
- ❌ “复制其他正常库的.mv.db再改名” → MVStore包含绝对路径哈希与UUID，跨环境易损坏。
? 补充：若需确保用户目录安全，可规范化路径：
// 推荐写法：使用用户主目录 + 安全文件名
String safeName = nome.getText().replaceAll("[^a-zA-Z0-9_\-]", "_");
String dbPath = System.getProperty("user.home") + "/h2dbs/" + safeName;
new File(dbPath).getParentFile().mkdirs(); // 确保父目录存在
String jdbcUrl = "jdbc:h2:file:" + dbPath + ";AUTO_SERVER=TRUE";总结：H2的嵌入式设计哲学是“连接即契约”——只要JDBC URL合法、路径可写、驱动就绪，建库、初始化、事务管理均由H2内核全自动完成。放弃对.mv.db文件的手动干预，是保障数据一致性和服务稳定性的第一准则。
