本文详解 macOS（尤其是 Ventura 及更新版本）中使用 H2 嵌入式数据库时出现“Operation not permitted”错误的根本原因与可靠修复方法，重点解决 JDBC 连接路径配置不当引发的 FileSystemException。
本文详解 macos（尤其是 ventura 及更新版本）中使用 h2 嵌入式数据库时出现“operation not permitted”错误的根本原因与可靠修复方法，重点解决 jdbc 连接路径配置不当引发的 `filesystemexception`。
在 macOS 系统（特别是 Ventura 13.2.1 及后续版本）中，H2 数据库通过 JDBC 启动嵌入式模式时若指定绝对路径（如 /Users/Franco/Desktop/h2），常会抛出如下关键错误：
IO Exception: "java.nio.file.FileSystemException: /Users/Franco/Desktop/h2: Operation not permitted" [90031-212]
该错误并非 Java 或 H2 本身的缺陷，而是 macOS 强制执行的 Sandbox 文件访问限制所致：自 macOS Catalina 起，桌面（Desktop）、文档（Documents）、下载（Downloads）等用户目录默认受“完全磁盘访问”（Full Disk Access）权限管控；即使路径存在且可读，JVM 进程若未获显式授权，H2 尝试创建/写入数据库文件（如 h2.mv.db）时即被内核拒绝。
✅ 正确解决方案：改用用户主目录相对路径
H2 官方支持 ~ 符号解析为当前用户的主目录（即 /Users/<username>），该路径属于系统默认允许 JVM 访问的安全区域，无需额外授权。将原连接字符串：
// ❌ 错误：指向受保护的 Desktop 目录
Connection con = DriverManager.getConnection("jdbc:h2:/Users/Franco/Desktop/h2/bin", "root", "myPassword");替换为：
立即学习“Java免费学习笔记（深入）”；
// ✅ 正确：使用波浪线 ~ 指向主目录（安全、免授权）
Connection con = DriverManager.getConnection("jdbc:h2:~/h2", "root", "myPassword");? 注意：~/h2 表示数据库文件将实际创建于 /Users/Franco/h2.mv.db（及配套日志、锁文件），而非桌面目录。路径末尾不加 /bin——H2 会自动在指定目录下管理数据库文件，/bin 是 H2 工具包目录，非数据库路径。
? 完整修正后的代码示例
import java.sql.*;
public class Main {
public static void main(String[] args) throws Exception {
Class.forName("org.h2.Driver");
// ✅ 关键修正：使用 ~/h2 替代绝对 Desktop 路径
Connection con = DriverManager.getConnection("jdbc:h2:~/h2", "root", "myPassword");
Statement stmt = con.createStatement();
String createSql = """
DROP TABLE IF EXISTS TEST;
CREATE TABLE TEST(ID INT PRIMARY KEY, NAME VARCHAR(255));
INSERT INTO TEST VALUES(1, 'Hello');
INSERT INTO TEST VALUES(2, 'World');
""";
stmt.execute(createSql);
ResultSet rs = stmt.executeQuery("SELECT * FROM TEST");
while (rs.next()) {
System.out.println(rs.getInt("ID") + ": " + rs.getString("NAME"));
}
con.close();
}
}⚠️ 其他注意事项
- 避免使用 newInstance()：Class.forName("org.h2.Driver").newInstance() 已过时（Java 6+ 自动注册驱动），直接 Class.forName("org.h2.Driver") 即可。
- 路径语义澄清：jdbc:h2:~/h2 中的 ~/h2 是数据库名（也是文件前缀），H2 会生成 h2.mv.db 等文件；它不是文件系统路径拼接，勿添加 .mv.db 后缀。
- 调试技巧：首次运行后，可检查 ~/h2.mv.db 是否成功生成，确认权限生效。
- 备选方案（不推荐）：若必须存于 Desktop，需在「系统设置 → 隐私与安全性 → 完全磁盘访问」中手动为你的 IDE（如 IntelliJ IDEA）或终端应用开启权限——但此法增加安全风险且跨设备不可移植。
通过采用 ~ 路径，既规避了 macOS 的沙盒限制，又保持了代码简洁性与跨平台兼容性（Linux/macOS 通用，Windows 不支持 ~，但 H2 在 Windows 下通常无此权限问题）。这是面向 macOS 开发者最稳健、零配置的 H2 启动实践。
