本文详解 macOS（尤其是 Ventura 及更新版本）中使用 H2 嵌入式数据库时出现“Operation not permitted”错误的根本原因与可靠修复方法，重点解决 JDBC 连接路径配置不当引发的 FileSystemException。
本文详解 macos（尤其是 ventura 及更新版本）中使用 h2 嵌入式数据库时出现“operation not permitted”错误的根本原因与可靠修复方法，重点解决 jdbc 连接路径配置不当引发的 `filesystemexception`。
在 macOS Ventura（13.2.1+）及后续版本中，Apple 加强了沙盒机制与文件系统访问控制（尤其是对桌面、文档等受保护目录的硬性限制）。当 Java 应用通过 H2 的 JDBC URL 直接指定绝对路径（如 /Users/Franco/Desktop/h2）作为数据库文件存储位置时，JVM 进程若未获得对应目录的完全磁盘访问权限，H2 在尝试创建或写入数据库文件（如 h2.mv.db）时将触发 java.nio.file.FileSystemException: Operation not permitted —— 这并非 H2 或 JDBC 配置错误，而是 macOS 系统级安全策略的明确拦截。
关键问题在于你当前的连接字符串：
Connection con = DriverManager.getConnection("jdbc:h2:"+ "/Users/Franco/Desktop/h2/bin", "root", "myPassword");该写法存在两个严重隐患：
- ❌ 路径指向 Desktop/h2/bin（疑似误将 H2 安装目录当作数据库路径）；
- ❌ 使用绝对路径 /Users/.../Desktop/... 触发 macOS 全盘访问限制（即使已授权 IDE，JVM 子进程未必继承权限）。
✅ 正确做法是：改用用户主目录相对路径（~）并确保目标目录可写。H2 会自动将 ~ 解析为当前用户的家目录（如 /Users/Franco），该路径默认具备读写权限，且绕过 macOS 对桌面/下载等敏感目录的强制管控。
✅ 推荐解决方案（一行修复）
将连接 URL 修改为：
Connection con = DriverManager.getConnection("jdbc:h2:~/h2", "root", "myPassword");? 此处 ~/h2 表示数据库文件将生成在 /Users/Franco/h2.mv.db（主目录下），无需额外授权，兼容所有 macOS 版本。
? 完整修正后的代码示例
import java.sql.*;
public class Main {
public static void main(String[] args) throws Exception {
Class.forName("org.h2.Driver"); // .newInstance() 已废弃，可省略
// ✅ 关键修正：使用 ~/h2 替代绝对路径
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();
}
}⚠️ 注意事项与最佳实践
- 不要手动创建数据库目录：H2 会自动创建 ~/h2.mv.db 文件，无需预先建目录或放 .bin 后缀。
- 避免使用受保护路径：除 ~/ 外，也可选用 ./data/h2（当前项目目录下），但需确保 IDE 运行工作目录正确。
- macOS 权限检查：若仍报错，请前往「系统设置 → 隐私与安全性 → 完全磁盘访问权限」，确认你的 IDE（如 IntelliJ IDEA、VS Code）和终端（如 iTerm）已勾选。
- H2 URL 格式规范：标准格式为 jdbc:h2:[file:][path]，file: 可省略；~/h2 等价于 file:~/h2，H2 内部自动处理波浪线展开。
通过此调整，你既能规避系统权限墙，又能保持开发环境简洁——无需降级系统、关闭 SIP 或复杂签名操作。记住：在 macOS 上，信任 ~，远离 /Users/xxx/Desktop/ 类绝对路径，是嵌入式数据库开发的第一守则。
